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Preface 



System generation is the process by which an operating system is created or 
modified. The system that is being created or modified is tailored to the 
machine configuration and data processing requirements of an installation by 
the specifications you provide to the system generation program. 

This publication provides you with the information necessary to: 

• Prepare for the system generation process. 

• Execute the system generation process. 

• Test the results of the system generation. 

The information in this manual is provided in the following sections : 

"Introduction" describes the four types of generation that you can specify — 
a complete generation, a nucleus generation, an I/O device generation, and a 
processor/library generation. 

"Preparation for System Generation" describes the preparatory steps necessary 
for a system generation and provides examples to illustrate the coding required 
for each step; provides the requirements for the generating system and the 
steps necessary to prepare the system; includes considerations for using an 
MFT or MVT system as the generating system; describes the procedure for adding 
user-written functions to the new SYS 1 .NUCLEUS, SYS1.SVCLIB, and SYS1 .LINKLIB; 
the requirements and detailed operating procedures for the starter operating 
system package; and provides the requirements for the new or modified system 
and the steps required to initialize, allocate space on, and catalog any new 
direct-access volumes that will be used. 

"The Job Stream" provides a diagram and brief description of the job stream 
that is the result from Stage I of the system generation program. 

"Operating Considerations" briefly describes various situations that will 
probably be encountered by the console operator during the execution of the 
system generation program. 

"Restart Procedures" describes the restart procedures that may be required 
during Stage I or Stage II of the system generation program and provides 
instructions and coding examples for recovering. 

"Testing the New System" provides the operating procedures for the sample 
programs that are included in the starter operating system package. 

"Examples" provides four examples, each of which illustrates the generation 
of a particular type of control program as well as showing how to do various 
types of generation; illustrates data set allocation and the coding required 
for the entire system generation process. 

"Program Options Descriptions" provides a brief summary of each operating 
system option available. 

"Data Sets" contains the detailed information about the required and optional 
data sets for the generating operating system and the new or modified operating 
system. 

"System Generation Macro Instructions" provides detailed coding information 
for each system generation macro instruction followed by a table showing any 
cross-reference relationship between various macro instructions, and provides 
guidelines for carrying out the various types of system generation. 
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"Appendixes" provides the following: 

A list of device type names provided on every operating system. 

• The additional preparation required if more than 96 I/O devices are to be 
specified during system generation. 

• The distribution methods are discussed. 

• The messages produced during system generation. 
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The 3420/3803 magnetic tape subsystem and 3410 tape subsystem are specified 
by use of the IODEVICE macro and the IOCONTRL macro. The devices, their 
features, and use are described in "IODEVICE," "IOCONTRL," "SORTMERG," "Dynamic 
Device Reconfiguration (DDR)," "SYS1 . DUMP, " and "Appendix A: Device Types." 



3505 CARD READER AND 3525 CARD PUNCH WITH READ AND PRINT FEATURE 

The 3505 is a card reader and the 3525 is a card punch with a read and punch 
feature. They are specified in the IODEVICE macro and illustrated in a maximum 
system configuration for the starter system in Figure 20. Their use is 
explained in Figure 20 "Minimum I/O Requirements," Figure 22 "Device Types," 
Figure 23 "Group Names Supporting IBM-Supplied Catalog Procedures" and Figures 
84 and 86 (unit addresses that can be specified in CONSOLE and ALTCONS 
parameters of the SCHEDULR and SECONSLF. macros) . The 3505/3525 devices are 
also described in "Appendix A: Device Types." 



2596 CARD READ PUNCH 

The 2596 is functionally equivalent to the 1442 N1 card read punch. The method 
for specifying it is described in the IODEVICE macro. The device is described 
in "Appendix E: Functionally Equivalent I/O Devices." 



S/370, MODEL 135 

Support for the S/370 Model 135 is described in the EMULATOR macro, the CTRLPRG 
macro and Figures 84 and 86 (unit address specified for CONSOLE and ALTCONS 
parameters of the SCHEDULR and SECONSLE macros) . The machine check handler 
support for the S/370, Model 135 is described in "SYS1 .SVCLIB. " Channel check 
handier support for S/370, Model 135 is described in "Channel Check Handler 
(CCH) " and the SUPRVSOR macro. S/370 Model 135 features and storage size are 
specified in the CENPROCS macro. SER defaults for the Model 135 are listed 
in Figure 87. 

S/370, MODEL 195 

The S/370, Model 195 is shown in Figure 20. "Maximum System Configuration for 
the Starter Operating System" . It is specified in the CENPROC macro and it 
supports the channel-check handler option (see "Channel-Check Handler"). 



RDE (Reliability Data Extractor) 

RDE is a new option specified and described in the SUPRVSOR macro, 
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STATUS DISPLAYS 

The SECONSLE and SCHEDULR macros specify status displays for displays consoles. 
New parameters specifying size of the status displays, the modules that support 
them, features, and restrictions are given in these macros. The Multiple 
Console Support option describes the requirements for status displays. A new 
data set, "SYS1 .DCMLIB, " description has been added for the display control 
module group and a new macro description, "DCMLIB," has been added to explain 
how to specify the inclusion of the SYS1. DCMLIB data set into the system. 



GENERALIZED TRACE FACILITY (GTF) 

Figure 76 shows from which generating system data sets GTF modules are taken 
and into which new system data sets the GTF modules are placed. The GTF 
requirements and restrictions are described in "Trace Option," "Timing Options," 
and the PARTITNS macro. 



SPECIFICATION CHANGES 



SERVICE AIDS 



Service aids in Figure 76, "Components and Generating System Data Sets," and 
in the CTRLPROG and MACLIB macro has been changed from an option to a 
requirement. 

EXISTING OPERATING SYSTEM 

The Release 21 level of linkage editor, IEHIOSUP, and IFCDIPOO must be used 
when a prerelease-21-level operating system is to be used to generate a new 
system. See "System Generation Using an Existing Operating System." 



SORTMERG SIZE PARAMETER 

The values for S in the SIZE parameter formula have been changed and the 
description expanded. 



RESIDENT BSAM MODULES 

RESIDNT=ACSMETH in the SUPRVSOR Macro: BSAM modules must be resident to provide 
dumps of main storage during abnormal termination and for the system management 
facilities in MFT. Descriptions for making these modules resident have been 
added to this subparameter description. Another requirement description for 
specifying RESIDNT=ACSMETH has also been added. 
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OPTIONS=LOG in the SCHEDULR macro: A description of the BSAM mcdules that must 
be resident when this subparameter is specified in an MFT system has been 
added . 

ACCTRTN=SMF in the SCHEDULR Macro: A description of the BSAM modules that must 
be resident when this subparameter is specified and system management facilities 
is a data set on a direct-access device or a recording on tape has been added. 



2803 AND 2804 

A feature for the 2813 Model 3, described in Figure 80 "Keyword Values for 
IOCONTRL Macro Instruction", has been changed. The 2804 Model 3 description 
in this figure has also been changed. 



ACSMETH= IN THE DATAMGT MACRO 



The requirement for this subparameter has been deleted. 



ALTERNATE PATH RETRY (APR) , DYNAMIC DEVICE RECONFIGURATION (DDR) , AND CHANNEL 
CHECK HANDLER (CCH) OPTIONS 

A description about the VARY PATH function of alternate path retry has been 
added to the option description, a description of an operator requirement for 
permanent I/O error detected by the DDR routines has been added to the DDR 
option description, and a note about a restriction if neither APR, DDR, nor 
CCH is chosen has been added to the APR and DDR option description. 



SYS1 .LOGREC 

A description about reallocating this data with IFCDIP00 has been added to 
this data set description. 

2250, 2305, or 3330 

Specification descriptions and restrictions for the 2250, 2305, or 333 have 
been added to the IODEVICE macro description. 

3270 Display System 

Specification descriptions for the 3270 display system has been added to the 
IODEVICE macro and IOCONTROL macro descriptions. 
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MISCELLANEOUS TECHNICAL CHANGES 



M6 5MP ; Information in this publication fcr TSO with the Model 65 
Multiprocessing (M65MP) configurations is for planning purposes only until 
that item is supported. 

SYS1 .DUMP: The DD statement in this data set description as to when the DD 
statement is used and what happens if SYS 1. DUMP is not allocated but is 
cataloged has been changed. 

SYS1 .MODGEN: SYS1.M0DGEN in the starter operating system has been expanded 
into SYS1. MODGEN and SYS1 .M0DGEN2. 

DASDI, DUMPREST, AND RECOVREP : The description for specifying DASDI , DUMPREST, 
and RECOVREP in a PUNCH statement in "Testing the New System" has been expanded, 

Expiration Date with CSECT Identification Records; In "Input Deck for 

Initialization," an explanation about the high value of the expiration date 

when the CSECT identification record data is listed for programs link-edited 
during system generation has been added. 

COBOL F; All. information pertaining to COBOL F has been deleted. 

PCP; All information pertaining to PCP has been deleted. 

EDIT Macro: The TSO EDIT macro has been rewritten and expanded. 



MISCELLANEOUS PUBLICATION CHANGES 



SRL References: The titles of the books referenced in this manual have been 
changed. 
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Introduction 



The Operating System is composed of modules that can be united in a variety 
of combinations to meet the given requirements of a particular installation. 
You select the programming options that meet your data processing requirements 
and that conform to the processing, storage, and input/output facilities of 
your machine configuration. System generation is the process of interpreting 
your selection and combining the operating system modules into the system data 
sets that form your installation's new operating system. 

The new operating system is composed of the standard features incorporated 
in every operating system, those optional features selected from the distributed 
modules, and any additional features you provide. System generation also 
provides facilities for adding other features to the operating system after 
it has been generated. 

The system generation process and the types of system generation are discussed 
in the following sections. 



The System Generation Process 

System generation is a process that generates an operating system adapted to 
both the machine configuration and the data processing requirements of an 
installation. You specify the desired operating system through system 
generation macro instructions. During the system generation process, several 
operating system programs are used to build a new operating system according 
to the specifications in the macro instructions. These programs are executed 
under the control of an existing operating system (also called generating 
operating system or simply generating system throughout this publication) . 

An operating system is generated in two stages (see Figure 1) . During Stage 
I, the macro instructions that describe the installations machine configuration 
and the programming options desired are analyzed and used to generate a job 
stream. In Stage II, this job stream is processed to generate the libraries 
of modules that form the new operating system. These libraries contain modules 
supplied by IBM and, optionally, modules that you supply. 



STAGE I: PRODUCING THE JOB STREAM 

Stage I consists of two phases. During the first phase, all the macro 
instructions are analyzed for errors. Error messages are written for each 
error found. If errors are not found in any of the macro instructions, a job 
stream is produced during the second phase. If errors are found, however, 
the second phase is bypassed and the job stream is not produced. 



STAGE II: PROCESSING THE JOB STREAM 

During Stage II, the job stream is processed by the assembler, by the linkage 
editor, and by utilities. The following functions are performed: 

• Selected modules are assembled. 
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• The linkage editor combines the modules selected for inclusion in the 
resident portion of the control program (nucleus). 

• The linkage editor processes those selected modules to construct members 
of the new operating system libraries. 

• Utility programs complete the construction and initialization of the 
libraries selected for the new operating system. 

The generated operating system is then ready for use. 



TYPES OF GENERATION 

During each system generation process, you can specify one of four types of 
generation j 

• Complete operating system generation 

• Nucleus generation 

• Processor/library generation 

• I/O device generation 

In the first type, you specify the generation of an operating system consisting 
of either a control program only, or a control program, language processors, 
and their associated libraries. The control program specified can be 
multiprogramming with a fixed number of tasks (MFT) , multiprogramming with a 
variable number of tasks (MVT) , or a version of MVT that controls 
multiprocessing and uses two model 65s (M65MP) . Primary data management 
routines and system utilities are always provided with this type of generation. 
These standard features and the optional features specified are adapted to the 
installation's machine configuration during the generation process. 

A complete operating system generation should always be performed whenever 
changes are to be made to the system generation options for the control program 
or when, in some cases, the installation's machine configuration is to be 
modified. A complete operating system generation may not be needed if only 
changes to the nucleus of the control program are to be made. In this case, 
a new nucleus can be added to the operating system through a nucleus generation, 
A complete operating system generation may not be needed if only processor (s) 
are to be added to the system. A processor/library generation will accomplish 
this. A complete operating system may not be needed if the installation's 
machine configuration is to be modified. The reconfiguration can be done by 
an I/O device generation. 

In a nucleus generation, the user specifies that a nucleus is to be added to 
the operating system. The new nucleus must be of the same type (MFT, MVT, or 
M65MP) as that specified during the original complete operating system 
generation. That is, each nucleus of a given operating system must support 
the same control program, because the resident portion of the control program 
(nucleus) must be compatible with the nonresident portion. (SYS1 .NUCLEUS is 
the only system data set affected by a nucleus generation.) 

In a processor/library generation* you specify that processors and/or their 
associated libraries are to be added to the operating system. During the 
preparation for a processor/library generation, you must allocate space for, 
and, if desired, catalog any new system data set to be added to the operating 
system. If any of the existing system data sets are to be modified, you must 
have allocated sufficient space to those data sets when they were initially 
generated or, where permitted, provided for multiple extents in those data 
sets. \ 
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In an I/O device generation, you can add, delete, or change I/O devices, control 
units, or channels. You can add universal character set (UCS) support for 
the 1403 printer, change group names, change console specifications, add support 
for sharing direct-access devices, or change the address of any 2250 display 
units that are used for the graphic job processor (GJP) operations and/or 1130 
subsystems to be used for the satellite graphic job processor (SGJP) operations. 
You cannot add the programming support for additional access methods, 
telecommunications, or graphics. (SYS1 .NUCLEUS, SYS1 .LINKLIB, SYS1.SVCLIB, 
and SYS1.L0GREC are the data sets affected by an I/O Device.) 

During a nucleus generation or a processor/library generation, the generating 
system may also be the system being modified, that is, the generating system 
can add a new nucleus or processors and libraries to itself. However, for 
an I/O device generation, the system being modified cannot be the generating 
system. To facilitate the description of system generation, the terms new 
operating system or new system are used throughout this publication to mean 
either the operating system generated in a complete operating system generation, 
or the operating system modified by a nucleus, processor/library, or I/O device 
generation. 
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Figure 2 illustrates the four types of system generation. A complete operating 
system generation is performed first to produce the installations new operating 
system. A processor/library generation is used to add the PL/I processor and 
SYS1.PL1LIB to the new operating system. A nucleus generation adds a second 
nucleus to SYS 1 . NUCLEUS. An I/O device generation adds devices, control units, 
and channels to the system. 
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Figure 2. Types of System Generation 
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Preparation for System Generation 



Describes the preparatory steps necessary for a system generation and provides 
examples to illustrate the coding required for each step; provides the 
requirements for the generating system and the steps necessary to prepare the 
system; includes considerations for using an MFT or MVT system as the generating 
system; describes the procedure for adding the user-written functions to the 
new SYS1. NUCLEUS, SYS1 . SVCLIB, and SYS1 .LINKLIB; the requirements and detailed 
operating procedures for the starter operating system packages and provides 
the requirements for the new or modified system and the steps required to 
initialize, allocate space on, and catalog any new direct-access volumes that 
will be used- 
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Before an operating system can be generated, a new system-residence volume 
(that volume on which the nucleus library, the SVC library, the IPL program, 
the SYS1.L0GREC and SYS1.ASRLIB data sets, and the volume index of the catalog 
are located) , and any other direct-access volumes required, must be initialized. 
The highest level of the system catalog must be built on the new system- 
residence volume. Space must be allocated for the appropriate system data 
sets in the new operating system, and the appropriate data sets must be 
cataloged in the new system catalog. 

Volume initialization is performed by either the IEHDASDR system utility program 
or the IBCDASDI independent utility program. The IEHPROGM system utility 
program is used to build the volume index of the system catalog, to allocate 
space for system data sets, and to catalog data sets. This system utility 
can be executed at any time after the system-residence volume is initialized. 

The following paragraphs describe the initialization of the system-residence 
volume and other required direct-access volumes, the initialization of the 
system data sets, and considerations on allocating space for these data sets. 
Detailed descriptions of the utility programs and of the control statements 
they require are in OS Utilities. 



Initializing Direct-Access Volumes 

Initialization is the process of writing home addresses, a volume label, and 
a volume table of contents (VTOC) on a direct-access volume. In addition, 
the initial program load (IPL) program must be written on the direct-access 
volume that is to become the system-residence volume. 

The initialization functions are accomplished by either the IBCDASDI or the 
IEHDASDR utility program. IBCDASDI is self-loading and operates independently 
of the operating system. IEHDASDR operates under control of a Release 16 or 
later operating system. These programs and the control statements they require 
are described in OS Utilities . 

In addition to performing the initialization functions, these utility programs 
check for defective tracks and, if any are found, assign alternate tracks and 
issue appropriate messages. Alternate tracks are not accepted for track 
of the system-residence volume. (Track is required for the IPL program.) 
If track is found to be defective, another volume must be initialized for 
system residence. 

The IPL program (IEAIPLOO) is distributed with the starter system. The section 
"System Generation Using the Starter Operating System" describes the procedure 
used to punch IPL program cards for insertion into the IBCDASDI or IEHDASDR 
input deck whenever a system-residence volume is initialized. (IEHDASDR can 
also retrieve the IPL program directly from SYS1. SAMPLIB, as described in OS 
Utilities.) 

The system-residence volume must reside on a 2301, 2303, 2305, 2311, 2314, 
or 3330. For any device type the start address of its VTOC cannot be 0. 
If it resides on a 2303 or 2311, the start address of its VTOC cannot 
be or 1. 

Figure 3 is an example of the code for an input deck for initializing a system- 
residence volume using the IBCDASDI independent utility program. In this 
example, the volume to be initialized resides on an IBM 2311 Disk Storage 
Drive. The volume serial number to be written in the label is 111111. The 
volume table of contents (VTOC) starts at track 2 and is 8 tracks long. 
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Note: If the volume is being initialized for the first time, the parameter 
FLAGTEST=NO must be included in the DADEP statement (for 2311 and 2314 volumes 

only) . 

VOLINIT JOB -SYSTEM-RESIDENCE VOLUME INITIALIZATION- 

MSG TODEV=1403,TOADDR=00E -MESSAGE OUTPUT- 

DADEF TODEV=2311,TOADDR=191,IPL=YES, -VOLUME X 

VOLID=SCRATCH DEFINITION- 

VLD NEWVOLID=111111,OWNERID=DEPT89 -VOL LABEL DEF- 

VTOCD STRTADR=2,EXTENT=8 -VTOC DEFINITION- 
IPLTXT 

IPL PROGRAM (IEAIPLOO CARDS) 

END 

Figure 3. Initializing the System-Residence Volume With IBCDASDI 

The IEHDASDR system utility program can be used to perform the initialization 
shown in Figure 3. Figure 4 shows the job control language and utility control 
statements reguired by IEHDASDR. 

Note: If the volume is being initialized for the first time: 

• The device must be varied off-line before the IEHDASDR step is executed. 

• The DD statement that defines the volume must be omitted. 

• The value of the TODD keyword of the ANALYZE statement must be the address 
of the device. 

• The parameter FLAGTEST=NO must be included in the ANALYZE statement (for 
2311 and 2314 volumes only). 

//INIT JOB MSGLEVEL=1 -IEHDASDR INPUT DECK- 

//STEP EXEC PGM=IEHDASDR 

//SYSPRINT DD SYSOUT=A 

//VOL1 DD UNIT= (2311,, DEFER) ,DISP=OLD, X 

// VOLUME= (PRIVATE,, SER= 23 1 1AA) 

//SYSIN DD * 

ANALYZE TODD=VOL1,VTOC=2,EXTENT=8,NEWVOLID=1111 11, X 

IPLDD=SYSIN, OWNER ID=BGS 

IPLTXT 



IPL PROGRAM (IEAIPLOO CARDS) 



END 
/* 



Figure 4. Initializing the System-Residence Volume With IEHDASDR 



Initializing New System Data Sets 

The initialization of new system data sets is the process of allocating space 
to the system data sets, building the volume index of the system catalog, and 
cataloging system data sets in the system catalog. The contents of the system 
libraries are placed in the allocated space during system generation. The 
contents of the other data sets are placed in the allocated space during job 
execution in the generated operating system. 
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The volume index of the system catalog is built on the new system-residence 
volume by the IEHPROGH system utility program. This index contains the 
addresses of the system data sets that will form the new operating system. 
These data sets can be cataloged by the same utility program. 

Space should be allocated for these data sets (except for SYS1.L0GREC, 
SYS1. ROLLOUT, SYS1.ASRLIB and, sometimes, SYS1.DUMP) by DD statements included 
in the input to this system utility program. The amount of space to be 
allocated to each system data set is shown in OS Storage Estimates. 



Input Deck for Initialization 

The system data sets are allocated space and cataloged by the IEHPROGM utility 
program. Detailed descriptions of the control cards and functions of IEHPROGM 
can be found in the publication OS Utilities. The following text only describes 
the use of IEHPROGM for initializing the system data sets. 

The input deck for IEHPROGM must contain the following: 

• A JOB statement with any parameters reguired by the installation. 

• An EXEC statement with the PGM=IEHPROGM parameter. 

• A DD statement for the message output data set (SYSPRINT) . 

• A DD statement for each of the new system data sets (except for SYS1.L0GREC, 
SYS1. ROLLOUT, SYS1.DUMP, and SYS1 . ASRLIB) . These DD statements have the 
following format: 

//ddname DD DSNAME=dsname,VOLUME= (, RETAIN, SER=serial) , X 

// UNIT=unit,LABEL=EXPDT=99350,SPACE=(allocation) , X 

// DISP(,KEEP) ,DCB=(see Figure 77 in the "Data Set" X 

// section) 

• A DD * statement (SYSIN) . 

• A CATLG statement for each new system data set to be cataloged. Each CATLG 
statement must have the following format: 

CATLG DSNAME=dsname,CVOL=unit=serial,VOL=unit=serial 

The DD and CATLG statements and examples of allocation are discussed in the 
following sections. For more information on the coding of parameters, refer 
to OS Job Control Language Reference. 



DD Statements 

The DD statements in the input deck for initializing the system data sets have 
the following parameters: 

ddname 

name of the DD statement. 
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DSNAME=dsname 

name of the system data set. During the preparation for processor and 
libraries generation only those optional system data sets that are to be 
added to the system must be cataloged and allocated space. 

VOL0ME= (, RETAIN, SER=serial) 

serial number of the direct-access volume on which the system data set 
is to reside. 

UNIT=unit 

the name of the direct-access device that can be allocated to the system 
data set. It is recommended that the value given to UNIT be a unit name. 
(Unit names are listed in Appendix A.) 

LABEL=EXPDT=99350 

the expiration date for all data sets chosen to prevent accidental deletion. 

The data set protection provided by the expiration date requires additional 
action by the operator. If the current date is set in the generating 
system during system generation, the operator is required to override this 
current date each time a protected data set is opened. 

Another, more convenient method can be used. For the system generation job 
(or any time the data sets are to be modified) , the current date may be set 
at a higher value than the expiration date specified for the protected data 
sets. This may be done by the operator from the console, or by a card in the 
job stream. In either case, the current date should be reset in the generating 
system immediately after the completion of the system generation process. 
(See the "Operating Considerations" section.) 

Note that when the current date is set to a high value, the Linkage Editor 
produces CSECT identification records containing this high value. Thus, when 
CSECT identification record data is later listed for the programs link-edited 
during system generation, it appears as if these programs were link-edited 
on a high value. For a complete description of CSECT identification records, 
see the publication OS Loader and Linkage editor. 

SPACE 

the amount of auxiliary storage to be allocated to the system data set 
can be obtained from OS Storage Estimates. The directory quantities for 
the system libraries are also shown in that publication. 

Only the index of SYS1. must reside on the catalog of the system-residence 
volume. SYS 1. NUCLEUS and SYS1.SVCLIB must be allocated space entirely on the 
system-residence volume. SYS1.SVCLIB may not occupy more than 1023 tracks 
on the system-residence volume. (The size of SYS1.LOGREC is determined during 
system generation and is allocated on the systemresidence volume.) The maximum 
space that can be allocated to the remaining system data sets is one volume, 
except for SYS1 ,SYSJOBQE, which may not occupy more than 1215 tracks on a 2314 
and 745 tracks on a 3330. Alternative track assignment is accepted for the 
system data sets. To achieve maximum efficiency in the new system, alternate 
tracks should not be used for SYS1.SVCLIB, SYS1 .LINKLIB, and SYS 1.SYSJOBQE. 

DISP= (,KEEP) 

this parameter must be coded as shown. DISP= (,CATLG) cannot be used because 
the data set would be cataloged in the generating system rather than in 
the catalog of the new system-residence volume. 



DCB 



certain system data sets require a DCB parameter. See "Data Sets." 
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CATLG Statements 

The CATLG statements in the input deck for initializing system data sets have 
the following parameters: 

DSNAME=dsname 

name of the system data set to be cataloged. 

CVOL=unit=serial 

specifies the unit name and serial number of the new system-residence 
volume. (The values must be the same as those specified in the DD statement 
for SYS 1. NUCLEUS.) 

VOL=unit= serial 

the unit name and serial number of the volume on which the system data 
set resides. These values must be the same as those specified in the 
corresponding DD statement for the system data set. 



Sample Data Set Initializations 

This section contains two examples of initialization of system data sets. 
In the first example, all the system data sets required by a new system reside 
on one volume. In the second example, the system data sets of another new 
system are arranged on two volumes. 

The numbers chosen for space allocation in these two examples are for 
illustrative purposes only. Space requirements for the system data sets are 
determined by several factors, especially the type of device used and the 
characteristics of the system to be generated. For example, the processors 
chosen for the new system affect the size of SYS1.LINKLIB. Exact-auxiliary 
storage requirements on various types of direct-access devices can be obtained 
from OS Storage Estimates. 

Figure 5 is an example of an input deck for building the system catalog and 
for allocating space to the system data sets on one volume. It is assumed 
that the system-residence volume was initialized as shown in Figure 3 or Figure 
4. The new system reguires SYS1.MACLIB, SYS1.SVCLIB, and SYS1 .LINKLIB. The 
optional data sets SYS1 . SORTLIB, SYS1.COBLIB, SYS 1 .FORTLIB, and SYS 1. DUMP are 
to be cataloged in the new system. The unit for the new system— residence 
volume is a 2311. The serial number of the system-residence volume is 111111. 

Figure 6 is another example of an input deck for building the system catalog 
and for allocating space to the system data sets. The system data sets are 
to reside on two volumes. The unit for the system-residence volume is a 2301 
and its serial number is AAA111. The unit for the second volume is a 2311 
and its serial number is AAA 112. It is assumed that both volumes were 
previously initialized. The new system will include all the optional system 
data sets. 

The data sets SYS1.SVCLIB, SYS1.IMAGELIB, SYS1 .PARMLIB, SYS1 . PROCLIB, and 
SYS 1, LINKLIB are to be cataloged in the new system. All system data sets 
except SYS1. LINKLIB, SYS1.MACLIB, SYS1 .IMAGELIB, SYS1 .PARMLIB, SYS 1. PROCLIB, 
SYS1.SYSVL0GX, and SYS1 .SYSVLOGY reside on the system-residence volume. 
SYS1. LINKLIB, SYS1.MACLIB, SYS1 . PARMLIB, SYS 1. IMAGELIB, SYS 1 . PROCLIB, 
SYS1.SYSVL0GX, and SYS 1. SYSVLOGY reside on the second volume (AAA112). 
SYS1. ROLLOUT is cataloged on AAA112. 
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//SYSGEN JOB 
//STEPO EXEC 
//SYSPRINT DD 
//JOBQE DD 

// 

//SVCLIB DD 

// 

// 

//LINKLIB DD 

// 
// 

//CATALOG DD 

// 
// 

//PROCLIB DD 

// 

// 

//PARMLIB DD 

// 
// 

//SORTLIB DD 

// 
// 

//COBLIB DD 

// 

// 

//FORTLIB DD 

// 

// 

//MACLIB DD 

// 
// 

//NUCLEUS DD 

// 
// 
//SYSIN DD 

CATLG 

CATLG 

CATLG 

CATLG 

CATLG 

CATLG 

CATLG 

CATLG 



MSGLEVEL=1 -ALLOCATE ON ONE VOLUME- 

PGM=IEHPROGM 

SYSOUT=A 

DSNAME=SYS 1. SYSJOBQE, VOLUME= (, RETAIN ,SER=11 11 11) f 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (120) ,,C0NTIG) 

DSNAME=SYS1. SVCLIB, VOLUME= (, RETAIN, SER= 1 1 1111), 

UNIT=2311,DISP=(,KEEP) ,SPACE=(CYL, (15,1,75)) , 

LABEL=EXPDT=99350,DCB=(DSORG=POU,RECFM=U,BLKSIZE=1024) 

DSNAME=SYS1.LINKLIB,VOLUME=(,RETAIN,SER=111111) , 

UNIT=231 1,DISP=(,KEEP) ,SPACE= (CYL, (97,5, 100)) , 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=3625) 

DSNAME=SYSCTLG, VOLUME= (, RETAIN, SER=1 11111) , 

UNIT=231 1 ,DISP=(,KEEP) ,SPACE= (TRK, (10, 1) ) , 

LABEL=EXPDT=99350 

DSNAME=SYS1.PROCLIB,VOLUME=(,RETAIN,SER=111111) , 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (30,10,9)) , 

LABEL=EXPDT=99350,DCB=(RECFM=FB,BLKSIZE=3360) 

DSNAME=SYS1.PARMLIB,VOLUME=(,RETAIN,SER=111111) , 

UNIT=231 1,DISP=(,KEEP) ,SPACE=(TRK, (5, ,1) , ,CONTIG) , 

LABEL=EXPDT=99350,DCB=(RECFM=F,BLKSIZE=80) 

DSNAME=SYS1. SORTLIB, VOLUME=(, RETAIN, SER=11111 1) , 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (60,2,40)) , 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=3625) 

DSNAME=SYS1.COBLIB,VOLUME=(,RETAIN,SER=111111) , 

UNIT=2311,DISP=(,KEEP) , SPACE- (TRK, (35,2,30)) , 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=3625) 

DSNAME=SYS1. FORTLIB, VOLUME= (, RETAIN, SER= 1 1 1 1 1 1) , 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (50,2,40)) , 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=3625) 

DSNAME=SYS1.MACLIB,VOLUME= (,RETAIN,SER= 1 1 1 1 1 1) , 

UNIT=231 1,DISP=(,KEEP) ,SPACE=(TRK, (460,30,25) ) , 

LABEL=EXPDT=99350,DCB=(RECFM=FB,BLKSIZE=3360,LRECL=80) 

DSNAME=SYS1.NUCLEUS,VOLUME=(,RETAIN,SER=111111) , 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (30,, 1) ,,CONTIG), 

LABEL=EXPDT=99350 

* -INPUT FOR CATALOGING SYSTEM DATA SETS- 



CVOL=2311=111111,VOL=2311=1 
CVOL=23 11=11111 1 , VOL=23 1 1= 1 
CVOL=2311= 1111 11,VOL=231 1=1 
CVOL=23 11=11111 1 , VOL=23 11=1 
CVOL=2311 = 1 1111 1,VOL=231 1 = 1 
CVOL=23 11=111111, VOL=23 11=1 
CVOL=2311=111111,VOL=2311=1 
CVOL=2311=111111,VOL=2311=1 



11 11,DSNAME=SYS1. LINKLIB 
11 11,DSNAME=SYS1. MACLIB 
1111,DSNAME=SYS1.PROCLIB 
1111, DSNAME=SYS 1 . SORTLIB 
11 11, DSNAME=SYS1. COBLIB 
11 11,DSNAME=SYS1. FORTLIB 
1 1 1 1 ,DSNAME=SYS1 . SVCLIB 
1111, DSNAME=SYS 1 . DUMP 



/* 



Figure 5. 
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//SYSGEN 


JOB 


//ONE 


EXEC 


//SYSPRINT 


DD 


//JOBQE 


DD 


// 




//SVCLIB 


DD 


// 




// 




//CATALOG 


DD 


// 




/ 




//SORTLIB 


DD 


// 




// 




//COBLIB 


DD 


// 




// 




//FORTLIB 


DD 


// 




// 




//PL 1 LIB 


DD 


// 




// 




//ALGLIB 


DD 


// 




// 




//TELCLIB 


DD 


// 




// 




//NUCLEUS 


DD 


// 




// 




//LINKLIB 


DD 


// 




// 




//MACLIB 


DD 


// 




// 




//PROCLIB 


DD 


// 




// 




//PARMLIB 


DD 


// 




// 




//IMAGELIB 


DD 


// 




// 




// 




//ACCT 


DD 


// 




// 




//MVTLOGX 


DD 


// 




// 




//MVTLOGY 


DD 


// 




// 





MSGLEVEL=1 -ALLOCATE ON TWO VOLUMES- 

PGM=IEHPROGM 

SYSODT=A 

DSNAME=SYSl.SYSJOBQE,VOLUHE= (, RETAIN, SER=AAA 1 11), X 

UNIT=2301,DISP=(,KEEP) , SPACE=(TRK r (30) r/ CONTIG) 

DSNAME=SYS1.SVCLIB,VOLUME=( r RETAIN,SER=AAAl11) r X 

UNIT=2301,DISP= (,KEEP) ,SPACE= (TRK, (40, 10,75)) , X 

LABEL=EXPDT=99350,DCB=(DSORG=POU,RECFM=U,BLKSIZE=1024) 

DSNAME=SYSCTLG,VOLUME= (, RETAIN, SER=AAA1 11), X 

UNIT=2301,LABEL=EXPDT=99350,SPACE= (TRK, (2,1) ) , X 

DISP=(,KEEP) 

DSNAME=SYS1. SORTLIB, VOLUME= (, RETAIN, SER=AAA1 11) , X 

ONIT=2301,LABEL=EXPDT=99350,SPACE=(TRK, (15,2,40)) , X 

DISP= (,KEEP) ,DCB= (RECFM=U, BLKSIZE=20483) , 

DSNAME=SYS1. COBLIB, VOLDME=(, RETAIN, SER=AAA111) , X 

TJNIT=2301 , LABEL=EXPDT=99350,SPACE= (TRK, (10, 1,30) ) , X 

DISP= (,KEEP) ,DCB=(RECFM=0,BLKSIZE= 20483) 

DSNAME=SYS1. FORTLIB, VOLUME=(, RETAIN, SER=AAA111) , X 

UNIT=2301,LABEL=EXPDT=99350,SPACE= (TRK, ( 12, 2, 40) ) , X 

DISP=(,KEEP) ,DCB=(RECFM=O,BLKSIZE=20483) 

DSNAME=SYS1.PL1LIB,70LUME=(, RETAIN, SER=AAA111) , X 

DNIT=2301 ,LABEL=EXPDT=99350,SPACE= (TRK, (20, 10 ,65) ) , X 

DISP=(,KEEP) ,DCB=(RECFM=D,BLKSIZE=20483) , 

DSNAME=SYS1. ALGLIB, VOLDME=(, RETAIN, SER,AAA111) , X 

UNIT=2301,LABEL=EXPDT=99350,SPACE= (TRK, (10,2, 15) ) , X 

DISP=(,KEEP) ,DCB=(RECFM=U,BLKSIZE= 20483) 

DSNAME=SYS1.TELCMLIB,VOLDME=(, RETAIN, SER=AAA111) , X 

UNIT=2301,LABEL=EXPDT=99350,SPACE= (TRK, (10, 1, 10) ) , X 

DISP=(,KEEP) ,DCB= (RECFM=D,BLKSIZE= 20483) 

DSNAME=SYS1. NUCLEUS, VOLOME=(, RETAIN, SER=AAA111) , X 

UNIT=230 1 ,SPACE= (TRK, (10, , 1) , ,CONTIG) , X 

DISP=(,KEEP) f LABEL=EXPDT=99350 

DSNAHE=SYS1. LINKLIB, VOLUME= (, RETAIN, SER= AAA 1 1 2) , X 

UNIT= 231 1,DISP=(, KEEP) ,SPACE=(CYL, (125, 10, 100) ) , X 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=3625) 

DSNAME=SYS1. MACLIB, VOLUME= (, RETAIN, SER=AAA 1 12) , X 

UNIT=2311,LABEL=EXPDT=99350,SPACE= (TRK, (440,50,25) ) , X 

DISP=( r KEEP) ,DCB=(RECFM=FB,BLKSIZE=3360,LRECL=80) 

DSNAHE=SYS1.PROCLIB,VOLUME=( r RETAIN,SER=AAAl12) , X 

UNIT=2301,LABEL=EXPDT=99350,SPACE= (TRK, (30,10,9) ) , X 

DISP=(,KEEP) ,DCB=(RECFM=F,BLKSIZE=80) 

DSNAME=SYS1. PARMLIB, VOLUME=(, RETAIN, SER=AAA112) , X 

UNIT=2311,DISP=(,KEEP) ,SPACE= (TRK, (5, , 1) , , CONTIG) , X 

LABEL=EXPDT=99350,DCB=(RECFM=F,BLKSIZE=80) 

DSNAME=SYS1.IMAGELIB,VOLUME=(,RETAIN,SER=AAA112) , X 

UNIT=2311,DISP=(,KEEP) , X 

SPACE=(TRK, (5, ,3) ,, CONTIG) , X 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=10 24) 

DSNAME=SYS1.ACCT,V0LUME=(,RETAIN,SER=AAA112) , X 

UNIT=2311,LABEL=EXPDT=99350,SPACE= (TRK, (5) ) , X 

DISP= (,KEEP) ,DCB=(RECFM=U,BLKSIZE=3625) 

DSNAME=SYSl.SYSVLOGX,VOLUME=(,RETAIN,SER=AAA112) , X 

UNIT=2311,SPACE=(148, (100) ,, CONTIG) ,DISP= (, KEEP) , X 

LABEL=EXPDT=99350,DCB=(RECFM=VB,BLKSIZE=3625) 

DSNAME=SYS1.SYSVLOGY,VOLUME= (, RETAIN, SER= AAA 1 12) , X 

UNIT=2311 ,SPACE=(148, (100) ,, CONTIG) ,DISP= (,KEEP) , X 

LABEL=EXPDT=99350,DCB=(RECFM=VB,BLKSIZE=3625) 



Figure 6 (Part 1 of 2) . 
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//SYSIN DD * -INPUT FOR CATALOGING SYSTEM DATA SETS- 

CATLG CVOL=2301=AAA11 1, VOL=230 1=AAA1 1 1 ,DSNAME=SYS1 . PROCLIB 

CATLG CVOL=2301=AAA11 1 , VOL=230 1=AAA1 1 1 , DSNAME=SYS 1. SORTLIB 

CATLG CVOL=2301=AAA11 1, VOL=230 1=AAA1 1 1 ,DSNAME=SYS1 .COBLIB 

CATLG CVOL=2301=AAA1 1 1 , VOL=230 1=AAA1 11 , DSNAME=SYS 1 .FORTLIB 

CATLG CVOL=2301=AAA11 1, VOL=230 1=AAA1 1 1 ,DSNAME=SYS 1 .PL1LIB 

CATLG CVOL=2301=AAA11 1 , VOL=230 1=AAA1 1 1 , DSNAME=SYS 1. ALGLIB 

CATLG CVOL=2301=AAA1 1 1, VOL=230 1=AAA1 1 1 ,DSNAME=SYS1 .TELCMLIB 

CATLG CVOL=2301=AAA11 1,VOL=230 1=AAA1 1 1 , DSNAME=SYS 1 . SVCLIB 

CATLG CVOL=2301=AAA11 1,VOL=231 1=AAA1 12,DSNAME=SYS1 . LINKLIB 

CATLG CVOL=2301=AAA11 1 , VOL=23 1 1=AAA112, DSNAME=SYS 1 . MACLIB 

CATLG CVOL=2301=AAA11 1 , VOL=231 1 = AAA1 12,DSNAME=SYS1 . PARMLIB 

CATLG CVOL=2301=AAA11 1 , VOL=23 1 1=AAA1 12,DSNAME=SYS 1 . SYSVLOGX 

CATLG CVOL=2301=AAA11 1 , VOL=231 1 = AAA1 1 2 ,DSNAME=SYS1 .IMAGELIB 

CATLG CVOL=2301=AAA11 1 , VOL=23 1 1=AAA1 12, DSNAME=SYS 1- SYSVLOGY 

CATLG CYOL=2301=AAA11 1, VOL=23 1 1=AAA1 12 ,DSNAME=SYS1 . ROLLOUT 

Figure 6 (Part 2 of 2) . Initializing the System Data Sets -- 

Two-Volume Residence on a 2301 and 2311 



LOCATION OF SYSTEM DATA SETS 

Guidelines provided in this section show various ways to allocate space to 
the data sets reguired by the new system, and to the four utility data sets 
required during system generation. Two of the utility data sets must reside 
on direct-access volumes; the other two may reside on either magnetic tape 
or direct-access volumes. The location of the new system data sets is 
determined by: 

• The size of the system data sets, as given in the OS Storage Estimates. 

• The size of the utility data sets required for system generation, as given 
in the "Input Deck for System Generation" section. 

• The machine configuration, in particular the number and type of devices 
available in the generating system. 

• The use of the generating system data sets, new system data sets, and 
utility data sets during system generation. The generating system data 
sets and utility data sets are described in the "Data Sets" section. 

The following rules may be used to allocate the system data sets on the 
available volumes: 

• During Stage I and the assembly steps of Stage II of system generation, 
the volumes that contain the utility data sets for system generation must 
be mounted at the same time. 

• After the assembly steps of Stage II, SYS1.MODGEN, SYS1.MODGEN2, 
SYS1.TSOGEN, and two of the utility data sets (those that need not reside 
on direct-access volumes) are no longer needed and may be removed and the 
new system pack mounted. SYS1. MACLIB, SYS1.TSOMAC, and SYS1.TCAMMAC of 
the generating system may also be removed at this point if the MACLIB macro 
instruction is not used during system generation. If MACLIB is used, the 
volume that is to contain the new SYS 1. MACLIB must be mounted. (See the 
description of the MACLIB macro instruction in the section on "System 
Generation Macro Instructions.") 
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• After the IEBCOPY step of Stage II (produced if the MACLIB macro instruction 
is used), SYS1. MACLIB, SYS1.TSOMAC, and SYS1.TCAMMAC of the generating 
system may be removed. If the volume that contains the new SYS 1. MACLIB 

is not to contain any other new system data sets, it may also be removed. 

• The volumes that contain component libraries, the new system data sets, 
and the volumes that contain your modules to be added to the new 

SYS 1. NUCLEUS must be mounted before the Stage II link-edit steps are 
executed. 

• Before the IEBCOPY step is produced, if the SVCLIB or LINKLIB, or both, 
macro instructions are used, the volumes that contain your modules to be 
added to the new SYS1. SVCLIB or SYS1 .LINKLIB, or both, must be mounted. 
The volumes that contain the new SYS 1. SVCLIB or SYS 1 . LINKLIB, or both, 
must remain mounted. The volumes that contain the component libraries 
and the remaining new system data sets may be removed. 

If there are enough drives available, all generating system data sets, new 
system data sets, and system generation utility data sets should be mounted 
at the same time. If there are not enough drives, the volumes that contain 
data sets not reguired for a given step must be demounted and the volumes that 
contain the data sets reguired for that step must be mounted. The scheduler 
indicates to the operator which volume should be mounted. 

The new system data sets can be arranged in different ways on one or more 
volumes. For best performance, it is desirable to place the system data sets 
on more than one volume. Whenever possible, freguently used data sets should 
be located on a volume other than the system-residence volume. System data 
sets on the same volume should be arranged according to the interaction between 
them; the more interaction, the closer they should be placed. 

For example, for best performance, SYS 1. LINKLIB should be placed on a volume 
other than the system-residence volume. However, if it must be on the system- 
residence volume, it should be adjacent to SYS1. SVCLIB, because SYS1. LINKLIB 
and SYS 1. SVCLIB are freguently used data sets and are closely related. In 
this same example, space for SYS1. NUCLEUS should be allocated last, because 
this data set is referred to only by the IPL program. 

If there are not enough drives available to achieve the desired distribution 
of new system data sets, the IEBCOPY utility program can be used to distribute 
the data sets after system generation. If SYS1. SVCLIB is changed, replaced, 
or moved after system generation, the IEHIOSUP utility program must be executed. 
If the MACLIB macro instruction was not used during system generation, the 
IEBCOPY utility program can be used to copy SYS 1. MACLIB from the generating 
system to the new system. 

The following pages contain examples of allocation on systems with three and 
four direct-access devices. In all these examples, the five utility data sets 
reguired for system generation are called SYS1.SYSUT1, SYS1.SYSUT2, SYS1.SYSUT3, 
SYS1.SYSUTU, and SYS1.0BJM0D. SYS1.SYSUT1 and SYS1.SYSUT2 may reside on 
magnetic tape. 



Generating a New System onto One Volume Using Four 2311 Drives 

Figure 7 shows the distribution of data sets using four 2311 disk storage 
drives and six volumes. The generating system data sets reside on DLIB01, 
DLIB02, DLIB03, DLIB04, and DLIB05. All the new operating system data sets 
reside on TARGET. The scheduler, when reguired, reguests the demounting and 
mounting of the proper volumes. 
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MtVC * 



BMfVt #S 




STAGE II 
ASSEMBLIES 
MACLIB COPY 



NUCLEUS LINK EDIT 

LINK EDITS 

COPIES 

IOSUP 

SER 

EREP 

IEHLIST 



DRIVE #4 



SVSLMODGEN 





COMPONENT 
LIBRARIES 





component 
libraries 




notes: y indicates when packs are changed. 

*- these drives should be offline when the stage d job stream is read in ; this will allow 
for the demounting and mounting of the disc packs. 



Figure 7. Example of Generation on Four Drives 
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Generating a New TSO System on One Volume Using Four 2311 Drives 

Figure 8 shows the distribution of data sets using four 2311 disk storage 
drives and seven volumes. All the new system data sets reside on TARGET. 
The generating system data sets reside on DLIB01 r DLIB02, DLIB0 3, DLIB04, 
DLIB05, and DLIB06. The scheduler, when reguired, reguests the demounting 
and mounting of the proper volumes. 



MtVt#l 



0NIVE #2 



DftlV£#3 



DRIVE #4 



STAGE I 
STAGE II 
ASSEMBLIES 




TSO LINK EDIT 
TSO COPIES 
MACLIB COPY 



NUCLEUS LINK EDIT 
LINK EDITS 
COPIES 



LINK EDITS 

COPIES 

I OS UP 

SER 

EREP 

IEHLIST 




COMPONENT 
LIBRARIES 



component 
libraries 






S VS1.M0DGEN 





NEW 

SYSTEM 

DATA 

SETS 



NOTES: ><C INDICATES WHEN PACKS ARE CHANGED. 

* THESE DRIVES SHOULD BE OFFLINE WHEN THE STAGE H JOB STREAM IS READ IN; THIS WILL ALLOW 
FOR THE DEMOUNTING AND MOUNTING OF THE DISC PACKS. 



Figure 8. Example of Generation on Four 2311 Drives 
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Generating a New System On One Volume Osinq Two 2314 Drives 

Figure 9 shows the distribution of data sets using two 2314 direct-access 
drives. All new system data sets are located on TARGET. The generating system 
data sets are located on DLIB01 and DLIB02. 



DRIVE NO. 1 



DRIVE NO. 2 



STAGE I 



STAGE II 
ASSEMBLIES 



STAGE II 

M ACL IB COPY 

NUCLEUS LINK EDIT 

LINK EDITS 

COPIES 

IOSUP 

SER 

EREP 

IEHLIST 




NOTE: X INDICATES WHEN PACKS ARE CHANGED 

I 



Figure 9. Example of Generation on Two 2314 Drives 

Notes: SYSIN spooling should be on DLIB02 and TARGET. To force SYSIN spooling 
to DLIE-02 and TARGET, these packs must have the lowest available addresses. 
The output data sets must be written directly to the printer using the direct 
SYSOOT writer (DSO) . (See OS Job Control Language Reference for a description 
of DSO) . 

Stage I: Output must be punched cards and the utility data sets must be 
temporarily allocated on DLIB01 and DLIB02. (See Figure 14 for Stage I space 
estimates.) 



18 



OS System Generation 



Stage II Assemblies: Stage II should be separated into two job streams. The 
assemblies should be in the first job stream and the copies, link-edits, and 
utilities should be in the second job stream. Allocate and catalog the utility 
data sets before reading in the assembly job stream. (See Figure 14 for Stage 
II space estimates.) 

Stage II Link Edits, Copies, and System Utilities: Allocate the new system 
data sets after replacing DLIB02 with TARGET. Read in the second job stream. 



Generating a Hew System on One Volume Using Three 2314 Drives 

Pigure 10 shows the distribution of data sets using three 2314 direct-access 
drives. All new system data sets are located on TARGET. The generating system 
data sets are located on DLIB01 and DLIB02. 



STAGE I 

STAGE II 

ASSEMBLIES 

MACLIB COPY 

NUCLEUS LINK EDIT 

LINK EDITS 

COPIES 

IOSUP 

SER 

EREP 

I EH LIST 



DRIVE NO. 1 



DRIVE NO. 2 



DRIVE NO. 3 




Figure 10. Example of Generation on Three 2314 Drives 



Generating a New System on Two Volumes Using Four 2314 Drives 

Figure 11 shows the distribution of data sets using four 2314 direct-access 
drives. All new system data sets are located on TARGET 1 and TARGET2. The 
generating system data sets are located on DLIB01 and DLIB02. 



DRIVE NO. 1 



STAGE I 

STAGE II 

ASSEMBLIES 

MACLIB COPY 

NUCLEUS LINK EDIT 

LINK EDITS 

COPIES 

IOSUP 

SER 

EREP 

I EH LIST 



DRIVE NO. 2 



DRIVE NO. 3 



DRIVE NO. 4 




Figure 11. Example of Generation on Four 2314 Drives 
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Generating a New System on One Volume Using Two 3330 Drives 

Figure 12 shows the distribution of data sets using two 3330 direct-access 
drives. All new system data sets are located on TARGET. The generating system 
data sets are located on DLIB01. 



; I drive "in! 



J DRIVE #2| 



STAGE I 

STAGE II 

ASSEMBLIES 

MACLIB COPY 

NUCLEUS LINK EDIT 

LINK EDITS 

COPIES 

IOSUP 

SEH 

EREP 

IEHLIST 





Figure 12. Example of Generation on Two 3330 Drives 



Input Deck For System Generation 

The input deck required for Stage I of system generation consists of job control 
language statements and system generation macro instructions. The sequence 
of the deck and the job control language statements are shown in Figure 13. 
This figure represents a four-drive system generation. For other generations, 
only the underlined values need vary. (In Figure 13, the utility data sets 
are allocated on 2311 volumes whose serial numbers are DLIB01, DLIB04, and 
TARGET, and unit 182 if a 9-track magnetic tape is available.) It is 
recommended that the values given to the UNIT keywords of the DD statements 
be device types. (See Appendix A.) 

The first statement of the deck is an EXEC statement indicating that the 
generation process immediately follows the catalog building step described 
in the previous section. Alternatively, system generation can be defined as 
an independent job. 

The three DD statements named SYSDT1, SYSUT2, and SYS0T3 in Step 1 of the 
example in Figure 13 are used to allocate space to the three utility data sets 
required for Stage I of the system generation process. The five DD statements 
SYSUT1, SYSUT2, SYSUT3, SYSUT4, and OBJPDS shown in Step 2 are used to allocate 
space to the five utility data sets required in Stage II of the system 
generation process. 

These data sets are cataloged as SYS 1. name in the generating system, where 
the value of name cannot exceed eight alphameric characters, the first of which 
must be alphabetic. These names (SYS 1. name) must also be specified as the 
value of the corresponding keywords (OBJPDS, UT1SDS, UT2SDS, UT3SDS and 0T4SDS) 
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in the GENERATE macro instruction. The data set defined by the OBJPDS DD state- 
ment must be a partitioned data set. The other four data sets must be sequential 
data sets, of which the two specified by the SYSUT3 and SYSUT4 DD statement must 
reside on a direct^access volume. 



//SIEP1 EXEC PGM=ASHBLR -STAGE 1 INPUT DECK- 

//SYSLIB DD DSNAME=SYS1.GENLIB,DISP=0LD 

//SYSUT1 DD DSNAME=SYS1.UT1,V0LUME= (, RETAIN, SER= DLIB04 ) , X 

// UNIT= 2311 ,SPACE=(TRK. (370,10)) ,DISP= (NEW, DELETE) 

//SYSDT2 DD DSNAME= SYS 1.UT2 , VOLUME= (, RETAIN ,SER= DLIB0 1 ) , X 

// UNIT=23J_1,SPACE=(TRK, (260. 10) ) ,DISP= (NEW, DELETE) 

//SYS0T3 DD DSNA«E= SYS1.UT3 ,VOLUME= (, RETAIN, SER= DLIB0a ) , x 

// UNIT= 2311 ,SPACE=(TRK, (425,10_) ) ,DISP= (NEW, DELETE) 

//SYSPUNCH DD UNIT=i8_2,LABEL=(,NL) 

//SYSPRINT DD SYSODT=A 

//SYSIN DD * 



/* 

//STEP2 
//SYSOT1 

// 

//SYSDT2 

// 



// 

//SYSUT4 

// 

//OBJPDS 

// 
// 
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EXEC PGM=IEFBR14 -ALLOCATE WORK FILES FOR STAGE 2- 
DD DSNAME= SYS1.UT1 .VOLUME=(.RETAIN,SER= DLIB04 ) 

DISP=(,CATLG),UNIT=23_1J,SPACE=(TRK, (M,l£) ) 
DD DSNAME= SYS1 .UT2 . VOLUME= ( . RETAIN. SER=TJRGET) , 
DISP=(,CATLG) ,UNIT=23n,SPACE=(TRK, (7jQ,10J ) 



//SYSUT3 DD DSNAME= SYS1.UT3 .VOLUME= f. RETAIN. SER=( DLIB01) . 



DD 



DD 



DISP=(,CATLG) ,0NIT=23_il,SPACE=(TRK, (175.10)) 
DSNAME= SYS1.UT4 ,VOLUME= (, RETAIN, SER= ( DLIB01 ) , 
DISP=(,CATLG) ,UNIT= 2311, ,SPACE=(TRK, (7,10)) 
DSNAME= SYS1.0BJMOD .VOLU«E= (. RETAIN, SER= DLIB0 1 ) , 
DISP=(,CATLG) . UNIT= 23 1 1 ,SPACE= (TRK. (M, 10,14) ) 



START RDR,182 (Optional statement — see text) 



Note; Underlined values represent variables. All other values must be coded 
as shown. The continuation characters are in column 72. 

Figure 13. Input Deck organization for System Generation 

Figure 14 shows the values that may be used for the SPACE keyword in the utility 
data set's DD statements according to the type of direct-access device on which 
they may reside. The values shown in the table are for a minimum system 
configuration. To determine if there is enough space available in the direct- 
access volume, list its volume table of contents (VTOC) before Stage I using 
the IEHLIST utility program. 

If magnetic tape drives are available, the data sets specified by the SYSUT1 
and SYSUT2 DD statements can be assigned to 9-track magnetic tape. If only 
one utility data set is to reside on magnetic tape, the one specified by the 
SYSUT1 DD statement should be chosen. If the data sets defined by the SYSUT1 
or SYSUT2 DD statements reside on unlabeled magnetic tape, LABEL=(,NL) must 
be specified in the corresponding DD statement, and NL must be specified in 
the UT1SDS or UT2SDS keyword of the GENERATE macro instruction. 
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DD Statement 


Device 








Type 


SYSUT1 


SYSUT2 


SYSUT3 


Stage 


I 






2311 


370,10 


260,10 


425,10 


2301 


75,2 


65,2 


90,0 


2303 


225,10 


195,10 


320,10 


2305 


150,5 


100,5 


160 , 5 


2314 


250,5 


170,5 


290,5 


3330 


150,5 


100,5 


160,5 


Stage 


II 






2311 


80,10 


70,10 


175,10 


230 1 


20,2 


20,2 


14,2 


2303 


50,10 


50,2 


135,10 



SYSUT4 OBJPDS 



7,10 80,10,14 

2,5 20,2,14 

4,5 70,5,14 

2305 20,5 20,5 70,5 2,5 30,5,14 

2314 60,5 60,5 115,5 4,5 50,5,14 

3330 20,5 20,5 70,5 2,5 30,5,14 

Figure 14. Space Allocation (in Tracks) for Utility Data Sets 

The DD statement named SYSPDNCH defines the data set that is to contain the 
job stream produced during Stage I of system generation. If any error messages 
(see Appendix D) occur during system generation, the job stream is not produced. 
After a successful completion of Stage I, the job stream produced becomes the 
input to Stage II. (The Stage I output should be saved after system generation 
for maintenance purposes.) 

If the device defined by the SYSPONCH DD statement is a card punch, the operator 
is reguired to place the cards in an input device and to issue a START RDR 
command for that device. However, operator intervention can be eliminated 
by making the output (SYSPUNCH) of Stage I become the input to Stage II. If 
the value given to UNIT in the SYSPUNCH DD statement is the unit address of 
a magnetic tape drive, this can be accomplished by inserting a // START RDR,xxx 
statement after the /* card of the input deck (See Figure 13) . In this 
statement, xxx is the unit address given to UNIT in the SYSPUNCH DD statement. 

If there were any errors during Stage I, an end-of-file condition will be 
detected and the reader will be closed. 

Notice that 7-track tapes can be used for SYSPUNCH. DEN=0 and TRTCH=C are 
the defaults for the system; these should be specified in the DCB parameter 
of the DD statement. The "Operating Considerations" section indicates some 
of the conditions that reguire operator intervention, and shows sample console 
listings from system generation processes. 

Note; The input deck described is the input to Stage I of the system generation 
process. During Stage I, a job stream that serves as the input for Stage II 
is produced. After a satisfactory completion of Stage I, the beginning of 
Stage II is a logical restart point. If any errors that reguire restarting 
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from the beginning of Stage I are made, the data sets specified by the OBJPDS, 
SYSUT1, SYSUT2, and SYSUT3 DD statements may have to be scratched and uncataloged 
before restarting. For more information, refer to the "Restart Procedures" 
section. 



Including IEBUPDAT in the New System 

IBM supplies two system utility programs that can be used to update sequential 
or partitioned data sets: IEBOPDAT and IEBUPDTE. Only IEBUPDTE is incorporated 
in SYS1.LINKLIB of the new operating system as a result of the system generation 
process. Because only IEBUPDAT can handle alphabetic characters in the high- 
order position of the sequence field and flagged output, it may be necessary 
to include this utility program in your new system. 

To include IEBOPDAT in the new system, execute a separate job that will link- 
edit IEBUPDAT from SYS1.UT506 into SYS1. LINKLIB of the new operating system 
as soon as system generation is complete. At this time, SYS1.0T506 must still 
be mounted and cataloged. You must allocate additional space for this data 
set when SYS 1. LINKLIB is initialized for the new system. (See the section 
on "Initializing System Data Sets.") 

Figure 15 shows the required coding. You must provide the data for two of 
the parameters in the SYSLMOD DD statement: the volume name and unit type 
for SYS 1. LINKLIB of the new operating system. 

//LKED JOB 00,IEBUPDAT,MSGLEVEL=1 

//STEPA EXEC PGM=IEWL,PARM=» REUS, LIST, LET, XREF, DC, NCAL* 

//SYSUT1 DD UNIT=SYSDA,SPACE=(TRK, (10,10)) 

//SYSLMOD DD DSNAME=SYS 1 . LINKLIB, VOLUME=SER= LNKVOL ,UNIT= 231 1 , X 

// DISP=OLD 

//DT506 DD DSNAME=SYS1.UT506,DISP=OLD 

//SYSPRINT DD SYSOUT=A 

//SYSLIN DD * 

INCLUDE UT506 (IEBUPDAT) 

NAME IEBUPDAT (R) 
/* 

Note: Underlined values represent variables. All other values must be coded 
as shown. The continuation character is in column 72. 

Figure 15. Input Deck for Including IEBUPDAT in the New System 



Adding User-written Functions 

The system generation process provides facilities for adding your own functions 
to the new SYS1 .NUCLEUS, SYS1.SVCLIB, and SYS1. LINKLIB. These user-written 
functions must be load modules residing in a cataloged partitioned data set 
in the generating system; that is, each function must be compiled, link-edited, 
and placed in a cataloged partitioned data set before system generation. (Each 
load module must be a member of the data set.) The name of the partitioned 
data set must be of the form SYS 1. name. The name cannot exceed eight alphameric 
characters, the first of which must be alphabetic. The name of the partitioned 
data set and of the members that contain your functions are specified with 
system generation macro instructions. 

The RESMODS macro instruction specifies load modules, such as types 1 and 2 
SVC routines, to be added to SYS 1. NUCLEUS during the first link-edit step in 
Stage II. 
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The LINKLIB macro instruction specifies load modules, such as accounting 
routines, to be added to SYS 1. LINKLIB during an IEBCOPY step in Stage II. 
These load modules become members of SYS 1 .LINKLIB. 

The SVCLIB macro instruction specifies load modules, such as types 3 and 4 
SVC routines and nonstandard label routines, to be added to SYS1 . SVCLIB during 
an IEBCOPY step in Stage II. These load modules become members of SYS 1. SVCLIB. 

If SVCs are added to SYS1. NUCLEUS or SYS 1. SVCLIB, the SVCTABLE macro instruction 
must also be used. This macro instruction adds to the SVC table an entry that 
specifies the characteristics of each SVC added. 

The RESMODS, LINKLIB, SVCLIB, and SVCTABLE macro instructions are described 
in the "System Generation Macro Instructions" section. Accounting routines, 
SVCs, and nonstandard label routines are described in OS MVT Guide and OS MFT 
Guide. 
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RESMODS PDS=SYS1.USER,MEMBERS=ID 



For a more detailed description of the control statements reguired by the 
assembler and the linkage editor, refer to OS Assembler (F) Programmer's Guide. 



//USER 

//STEP1 

//SYSLI 

//SYSUT 

//SYSUT 

//SYSUT 

// 

//SYSPR 

//SYSGO 

// 

//SYSIN 
ID 



JOB MSGLEVEL=1 
EXEC PGM=ASMBLR,PARM=» NODECK, LOAD, LIST, NOTEST , NOXREF , NORENT • 



DD DSNAME=SYS1.MACLIB,DISP=OLD 

DD UNIT=SYSSQ,SPACE= (1700, (400,50) ) 

DD UNIT=SYSSQ,SPACE= (1700, (400,50) ) 

DD UNIT=(SYSSQ,SEP=(SYSUT1,SYSUT2,SYSLIB)) , 

SPACE=(1700, (400,50)) 
INT DD SYSOUT=A 

DD DSNAME=&LOADSET,UNIT=SYSSQ,SPACE= (80, (200,50)) , 

DISP=(MOD,PASS) 

* 



DD 
CSECT 
DC C'XXXXXXXXXX-NUCLEUS ID CSECT- XXXXXXXXXX' 

C OPERATING SYSTEM GENERATED — 5/20/67 • 

C» OWNER — DEPT. D58' 

C ' SUPPORTS— MFT-ALL ACCESS METHODS' 

C NUCLEUS — 01' 

C'XXXXXXXXXX-END ID CSECT-XXXXXXXXXX' 



DC 
DC 
DC 
DC 
DC 
END 



/* 

//STEP2 

//SYSLI 

//SYSLM 

// 

// 

//SYSUT 

// 

//SYSPRINT DD 

/* 

// 



:n 

[OD 



1 



EXEC PGM=IEWL,PARM=(XREF,LIST,NCAL) 
DD DSNAME=&LOADSET,DISP= (OLD, DELETE) 

DSNAME=SYS1 .USER (ID) ,UNIT=23 1 1 , DISP= (,CATLG) , 
VOLUME= (, RETAIN, SER=333333) , 
SPACE=(1024, (50,20,5) ) 
UNIT=(SYSDA,SEP=(SYSLIN,SYSLMOD)) , 
SPACE=(1024, (50,20,5)) 
SYSOUT=A 



DD 



DD 



Figure 16. Preparing a User-Written Load Module 
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Considerations for MFT or MVT (Including M65MP) Generating Systems 

The following items must be considered for an MFT or MVT (including M65MP) 
generating system: 

1. A system generation needs about 2500 tracks on 2311s for Stage II output 
data sets (SYSPRINT) . The required space may be on more than one volume. 
The type and number of volumes that can be used must be specified with 
the SYOUTDV keyword of the GENERATE macro instruction. All output data 
sets must stay mounted throughout Stage II. For MFT or MVT generating 
systems of Release 1 9 or later, the direct system output (DSO) procedure 
can be used to place the output directly on the printer or a magnetic tape. 

2. It is recommended that all volumes used specifically for system generation 
be private. This can be accomplished by using the PRESRES volume 
characteristics list of SYS1 .PARMLIB of the generating system. (For 
information about the PRESRES list, see OS MFT Guide and OS MVT Guide . ) 

3. The SYS1 .SYSJOBQE of the MFT or MVT (including M65MP) generating system 
should be large enough for system generation. An average-sized system 
generation needs about 300 tracks on a 2311. 

4. The SYS1 .SYSJOBQE of the MFT or MVT (including M65MP) generating system 
must have about 960 176-byte records allocated for the initiator. 

5. A JOB statement providing the job priority and region size should be 
included in the input deck and JOBSTMT=SUPPLIED should be specified in 
the GENERATE macro instruction. 

6. For creation of an operating system, the partition or region size required 
for Stage I depends on the global pack used. The suggested sizes are: 

• 54K if SGGBLPAK is used. This pack is the one usually used in the 
starter operating system. 

• 56K if SGPAK248 is used. This pack is used if more than 96 but not 
more than 248 devices are defined. 

• 58K if SGPAK768 is used. This pack is used if more than 248 but not 
more than 768 devices are defined. 

• 85K if SGPAK768 and 3330 direct-access devices are used. 

The requirements for Stage II vary according to the types of components in 
the generating system. 

Note : For more information about the global packs, refer to Appendix B. 

7. If your system generation contains a large number of selected software 
options, and a region of more than 150K is available, you should use IEBUPDTE 
to make the following change to the GENERATE macro in SYS1.GENLIB at the 
section doing linkedit of the nucleus. Change the JCL statement to read: 

iCol. 2 Col. 72| 

PUNCH '// PARM="NCAL,DC,SIZE= (1 96K, 6K) SSGCTRLC (1 0) SSGCTRLC (1 1 ) SSGCTR* 

8. For a generating system with extremely limited CPU storage and limited 
auxiliary storage, change the linkedit steps in the GENERATE macro (located 
in SYS1.GENLIB) to read as follows: 

iCol. 3 Col. 72J, 

PUNCH '// PARM="NCAL,DC,SIZE=(44K,6K) SSGCTRLC (10) SSGCTRLC (11) SSGCTR* 

9. If FORTRAN is being generated in your new system, you should list and update 
the Linkedit SIZE=parameter Cin SGIEK401 macro) to 86K,12K. (The SGIEK401 
macro is in SYS1 .GENLIB and the linkedit step has a size of 250K,50K. 

System Generation Using an Existing Operating System 

Your Operating System can be used as a generation system if it meets certain re- 
quirements. The data set requirements can be found in the "Data Sets" section and 
MFT and MVT considerations in the section, "Considerations for MFT or MVT (includ- 
ing M65MP) Generating Systems." When you use your own operating system you can: 

• Perform the system generation as the only job 

• Perform the system generation as just one of several jobs in the job stream 
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When you use the first method, you can perform some modifications on your 
operating system while it is being used as a generating system. When you use 
the second method, you can execute the system generation as just another job 
in the job stream. You cannot use the second method, however, to perform 
modifications on your operating system while it is being used as a generating 
system. 

Notes; 

When using an existing operating system prior to Release 21, the following 
procedures must be followed for Stage II to ensure that the release 21 level 
of linkage editor, IEHIOSUP, and IFCDIPOO are used to generate the new system. 

• The volume containing SYS1.LINKLIB in the starter operating system must 
be mounted during Stage II. 

• Supply your own job card for Stage II. 

• Supply a JOBLIB card. The JOBLIB card points to SYS1.LINKLIB in the Release 
21 starter operating system. 

• Use JOBSTMT=SUPPLIED in the GENERATE macro. 

The job card and the JOBLIB card must immediately precede the GENERATE macro 
as shown below. 

RE PRO 
//JOBCARD JOB (ACCTl23,Dept) , PROGRAMMER, MSGLEVEL= (1,0) 

REPRO 
//JOBLIB DD DSN=SYS1.LINKLIB,VOL=SER=DLIB01,UNIT=XXXX,DISP=SHR 

GENERATE JOBSTMT=SUPPLIED 

where: 

xxxx is the unit on which the starter operating system resides, such as a 2314. 

• Copy the module named IGG019C8 from SYS1.SVCLIB in the starter operating 
system to SYS1.SVCLIB in the generating system. 

• If your existing system is MVT, errors will occur if you use JOBLIB or 
STEPLIB DD cards pointing to the MFT starter system LINKLIB. 

SYSTEM GENERATION AS THE ONLY JOB (METHOD 1) 
The preparatory steps for this method are: 

• Catalog the reguired data sets. 

• Plan for SYS1.PROCLIB for the new operating system. 

• Allocate and catalog the data sets for the new operating system. 

• Allocate and catalog the utility data sets. 

• Obtain the catalog utility program (CTLG2311, CTLG231U, or CTLG3330) and 
the uncatalog utility program (UNCT2311, UNCT231H, or UNCT3330) . 

These preparatory steps are described in the following sections. 

Cataloging Data Sets 

Cataloging SYS1.GENLIB, SYS1.MODGEN, SYS1 .MODGEN2, SYS1.TSOGEN, and the 
component libraries: You must catalog SYS1.GENLIB, SYS1.MODGEN, SYS1.MODGEN2, 
SYS1.TSOGEN, and each reguired component library in your operating system 
catalog. Figure 76 contains the list of component library names in the starter 
operating system package. 
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//LISTCTLG 


JOB 


//STEPA 


EXEC 


//SYSPRINT 


DD 


//SYSRS 


DD 


//SYSIN 


DD 


LISTCTLG 



Although you can catalog SYS1.GENLIB, SYS1.H0DGEN, SYS 1. M0DGEN2, SYS1.TSOGEN, 
and selected component libraries by using the IEHPROGM utility program, an 
easier method is to use one of three utility programs — CTLG2311, CTLG2314, 
or CTLG3330 — and catalog all the data sets. The utility program selected 
depends on whether the starter operating system package being used for the 
generation is for the 23 1 1 > 2314, or the 3330. Then when the system generation 
process is finished, you can use either the UNCT2311, 0NCT2314, or the ONCT3330 
utility program to eliminate all the catalog entries that are no longer needed 
in the generating system. 

Because each catalog entry must contain the address of the appropriate starter 
operating system volume, you must list the catalog of the starter system using 
the IEHLIST utility program. The control statements for IEHLIST that will 
list the catalog of the 231 t starter operating system are shown in Figure 17. 
If you use the 23 14 or 33 30 starter operating system, change the UNIT keyword 
parameter in the DD statement to UNIT=2314 or UNIT=3330 and the VOL keyword 
parameter in the LISTCTLG statement t o VOL=2314=DLIB0 1, or VOL=3330=DLIB01 . 

ACCT, PROGRAMMER, MSGLEVEL=1 

PGM= IEHLIST 

SYSOOT=A 

UNIT=2311,DISP= (OLD, KEEP) , VOLUME=SER=DLIB0 1 

* 

VOL=2311=DLIB01 

/* 

Figure 17. Input Deck to List the Starter Operating System Catalog 

Obtaining and Cataloging SYS1.MACLIB, SYS1. PARMLIB, SYS1.COBLIB, SYS1 .FORTLIB, 
SYS1.PL1LIB. SYS1.SORTLIB. SYS1.TSOMAC. SYS 1 . TCAMMAC. SYS1.DPADS. SYS1.DHELP. 
and SYS1.DCMDLIB; You must have a SYS 1. PARMLIB in your new or modified system. 
If you want the PARMLIB from your operating system, then no special action 
is necessary. If you want the PARMLIB from the starter operating system, you 
must first uncatalog the PARMLIB in your system catalog and then catalog the 
PARMLIB from the starter operating system. 

SYS1. PARMLIB contains the RAM system parameter list (see "Required and Optional 
Data Sets for Generating Systems") . If the 3330 or 2305 is being used when 
generating a new operating system with an existing system, access methods 
IGG019C0, IGG019C4, IGG019EK, IGG019FN, and IGG019FP must be added to the RAM 
list. This can be done by using PARMLIB from the starter operating system 
as described above. After the above access method modules have been added 
to the RAM list, use the IPL procedure, step 16, "3330 Package -Tape 
Distribution." 

You must also have cataloged in your operating system a SYS1.MACLIB, 
SYS1.TSOMAC, and SYS1. TCAMMAC that are of the same release level as SYS1. GENLIB, 
SYS1.M0DGEN, SYS 1. M0DGEN2, SYS1.TS0GEN, and the component libraries being used 
for the generation. If you want SYS1.COBLIB (for COBOL E) , SYS1.PL1LIB, 
SYS1.SORTLIB, SYS1.HELP, SYS1.0ADS, and/or SYS1.CMDLIB in the new or modified 
system, you must also catalog them in your operating system; they must also 
be of the same release level as SYS1.GENLIB, SYS1.M0DGEN, and the component 
libraries being used. 

If your operating system has SYS1.MACLIB, SYS1.COBLIB (for COBOL E) , 
SYS1.PL1LIB, and/or SYS1.SORTLIB of a release level other than the level of 
the starter operating system volumes being used, then you must uncatalog those 
data sets before the substitute library or libraries are cataloged. 

If you want SYS 1. FORTLIB in the new or modified system, it is not necessary 
to locate a FORTLIB of a particular release level. If your operating system 
has a FORTLIB, no action is necessary. If your system does not have a FORTLIB 
and you want one in the new or modified system, define it as a null data set 
and catalog it in your operating system catalog. 
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Note t; If your operating system does not have the required MACLIB or any 
of the other data sets that are needed (COBLIB, PL1LIB, or SORTLIB) , obtain 
them from any system that is the correct release level. Use the IEHPROGM 
utility program to catalog them in your operating system. 

Note 2; If there are not enough drives available in your machine configuration 
to hold all the generating system data sets, the new system data sets, and 
the various additional data sets required, then determine if there is any space 
available on any of your system volumes. If there is enough space to hold 
one or more of the data sets, then use the IEBCOPY utility program to copy 
the data sets onto the volume or volumes. If this is not possible, then you 
will have to demount and mount volumes during the system generation process. 
(For examples of data set allocation, see Figures 7 through 11 in this section.) 



Planning for SYS1.PROCLIB 

If you want the SYS1.PR0CLIB from the starter operating system, you must copy 
it into the new system after the system generation process is complete. If 
you specify the system generation macro instruction PROCLIB, the SYS1.PR0CLIB 
from your operating system will be included in the new or modified system, 
not the one from the starter operating system. 

Allocating and Cataloging the Data Sets for the New System 

You must prepare the appropriate DD and CATLG statements for all the system 
data sets for the new or modified system that require them. Use the IEHPROGM 
utility program to allocate and catalog the data sets. (See the examples 
provided in "Input Deck for Initialization" and in "Location of System Data 
Sets" in this section.) 

The names for these system data sets must have the qualifier SYS1 preceding 
their simple names. You can specify INDEX=SYS1 in the GENERATE macro 
instruction, but because this form is the default option, you don't have to 
code it. 



Allocating and Cataloging the Utility Data Sets 

You must allocate space for and catalog five utility data sets in your operating 
system by means of JCL statements in your system generation input deck. 
(Detailed information about specifying these data sets is found in "Input Deck 
for System Generation" in this section. ) 

Four of these data sets must be sequential data sets and are used by the 
assembler, the linkage editor, and the utility programs during system 
generation. The fifth data set must be a partitioned data set and is used 
for the storage of object modules assembled during system generation. Two 
of the sequential data sets and the partitioned data set must reside on a 
direct-access volume. 



SYSTEM GENERATION AS ONE JOB IN THE JOB STREAM (METHOD 2) 

This method of generating a system is used when you include the system 
generation job with other jobs in the job stream. The system generation program 
is executed in a multiprogramming system, permitting you to have more than 
one system generation job in the same job stream. The preparatory steps for 
this method are: 
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• Catalog the required data sets. 

• Rename SYS1.HACLIB, SYS1 .PARMLIB, and SYS1.PR0CLIB in the starter operating 
system and catalog them by the new names. Also rename SYS1.C0BLIB, 
SYS1.F0RTLIB, SYS 1. PL 1LI3, and/or SYS1 . SORTLIB and catalog them by the 

new names if you want them in the new system. Catalog SYS1.DHELP, 
SYS1.D0ADS, and SYS1.DCMDLIB if you want them; you do not have to rename 
them. 

• Name selected data sets in the new or modified operating system with the 
qualifier used in the INDEX keyword parameter of the GENERATE macro 
instruction. 

• Obtain the catalog utility program (CTLG2311, CTLG231U, or CTLG3330) and 
the uncatalog utility program (0NCT2311, UNCT2314 or UNCT3330) . 

• Allocate and catalog the data sets for the new system. 

• Allocate and catalog the utility data sets. 

• Restore the data set names in the starter operating system catalog. 

Note 1; When the system generation job is just one job in the job stream, 
none of the system data sets in your operating system have to be uncataloged 
for that particular system generation* job. In addition, the data set 
SYS1.PR0CLIB in the starter operating system can be included in the new system 
during the system generation process. You cannot use this method, however, 
if you are modifying your own operating system. 

Note 2; When you have more than one system generation in the same job stream, 
be sure to: 

• Specify a different qualifier in the INDEX keyword parameter for each 
GENERATE macro instruction. 

• Specify five utility data sets for each generation in the job stream. 
Specify a unique name for- each utility data set, because there cannot be 
any duplicate data set names in the job stream. 



Cataloging the Required Data Sets 

Cataloging SYS1.GENLIB, SYS1. MODGEN, SYS 1 . H0DGEN2. SYS1.TS0GEN. and the 
Component Libraries: You must catalog SYS1.GENLIB, SYS1.M0DGEN, SYS1.TS0GEN, 
and the component libraries required for a particular system generation in 
your operating system catalog. 

Although you can catalog SYS1.GENLIB, SYS1.MODGEN, SYS1 .M0DGEN2, SYS1.TS0GEN, 
and selected component libraries by using the IEHPROGM utility program, an 
easier method is to use one of three utility programs — CTLG23 11, CTLG2314, 
or CTLG3330 — and catalog all the data sets. The utility program selected 
depends on whether the starter operating system package being used for the 
generation is for the 2311, 2314 or the 3330. Then when the system generation 
process is finished, you can use either the UNCT2311, 0NCT2314, or the ONCT3330 
utility program to eliminate all the catalog entries that are no longer needed 
in the generating system. 

In addition to cataloging the data sets mentioned above, the utility programs 
perform another required function — they rename (CTLG2311, CTLG2314, CTLG3330) 
and restore (UNCT2311, 0NCT2314, or DNCT3330) the names of seven data sets 
in the starter operating system catalog. (See the next topic.) The method 
for obtaining these utility programs is described later. 
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Renaming SYS1. MACLIB, SYS 1.PARMLIB, SYS1 , PROCLIB, SYS1 .FORTLIB, SYS1.PL1LIB, 

SYS1.COBLIB, and/or SYS1 . SORTLIB: You must rename the system data sets 

(SYS1. MACLIB, SYS1.PARMLIB, and SYS1 . PROCLIB) in the starter operating system 

and catalog them in the generating system catalog as SYS1 .DMACLIB , 

SYS 1.DPARMLIB, and SYS1 .DPROCLIB for the duration of the system generation 

process. 

If you want SYS1.C0BLIB, SYS1 .FORTLIB, SYS 1 . PL1LIB, and/or SYS1. SORTLIB in 
the new operating system, then you must rename these data sets in the starter 
operating system and catalog them in the generating system catalog as 
SYS1.DC0BLIB, SYS 1. DFORTLIB, SYS 1 .DPL 1LIB r and/or SYS 1. DSORTLIB. 

The easiest method is to use either the CTLG2311, CTLG2314, or the CTLG3330 
utility program to rename all seven data sets and do the cataloging described 
in the preceding topic before beginning the system generation process. Then 
when the system generation process is finished you can restore all seven names 
using either the UNCT2311, UNCT2314, or the UMCT3330 utility program. The 
method for obtaining these utility programs is described in the next section. 

To access these libraries during system generation, a name other than 
SYS1 must be specified in the INDEX= parameter of the GENERATE macro. 

SYS1. FORTLIB With User-written Modules: If the SYS 1. FORTLIB in your operating 
system contains your own modules that you want in the new operating system, 
then you must place them in SYS 1 .DFORTLIB. Use the IEBCOPY utility program 
to transfer the contents of the entire data set or to transfer just your own 
modules. This copying can be done after either one of the utilities, CTLG2311, 
CTLG2314, or CTLG3330, has been run. 

MACLIB, PARMLIB, and PROCLIB in the Starter Operating System; The SYS 1. MACLIB, 
SYS1.PARMLIB, and SYS 1. PROCLIB in the starter operating system are the ones 
that are incorporated into the new operating system. If you want your MACLIB, 
PARMLIB, and/or PROCLIB in the new operating system, use the IEBCOPY utility 
program to include them in the new system after system generation is over. 



Obtaining the Catalog and Uncatalog Utility Programs 

All six utility programs to catalog and uncatalog are in the starter operating 
system package as members of SYS 1 .SAMPLIB. They are in card format and you 
can punch them out by using the IEBPTPCH utility program. 

Figure 18 shows the control statements required to punch the utility programs 
for the 2311 starter operating system package from SYS 1. SAMPLIB. The underlined 
value must agree with the device type of a punch unit in your installation 
and, therefore, may be different from the value shown. If you want the utility 
programs for the 2314 or 3330 starter operating system package, just substitute 
2314 or 3330 wherever 2311 appears in Figure 18. 



//PUNCH JOB MSGLEVEL=1 

// EXEC PGM=IEBPTPCH 

//SYSUT1 DD DSNAME=SYS1. SAMPLIB, DISP= (OLD, KEEP) , 

// UNIT=2 311,VOLUME=SER=DLIB03 

//SYSDT2 DD UNIT= 2540-2 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD * 

PUNCH TYPORG=PO,MAXNAME=2 

MEMBER NAME=CTLG2311 

MEMBER NAME=UNCT2311 
/* 

Figure 18. Input Deck for Punching the Catalog and Uncatalog Utility 
Programs 
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Allocating and Cataloging the Data Sets for the New System 

You must prepare the appropriate DD and CATLG statements for all the system 
data sets that require them. Use the IEHPROGM utility program to allocate 
and catalog the data sets. (See the examples provided in "Input Deck for 
Initialization" and in "Location of System Data Sets" in this section.) 

If any of the following seventeen data sets are selected for the new system, 
you must define them in DD statements with the user-supplied qualifier that 
has been specified in the INDEX keyword parameter of the GENERATE macro 
instruction; ALGLIB, CMDLIB, COBLIB, DCMLIB, FORTLIB, HELP, IMAGELIB, LINKLIB, 
MACLIB, NUCLEUS, PARKLIB, PL1LIB, PROCLIB, SORTLIB, SVCLIB, TELCMLIB, UADS. 
All other data sets you select are defined with SYS1 as the qualifier. For 
example, if INDEX=TEMP is specified, then the procedure library (PROCLIB) is 
defined in the DD statement as DSNAME=TEMP. PROCLIB, but the system job queue 
(SYSJOBQE) would be specified as DSNAME=SYS1 .SYSJOBQE. 

The use of your qualifier permits a data set to have a temporary, but unique, 
identification for the duration of the system generation process. At the end 
of the system generation process, the qualifier you supply is replaced by SYS1 
by the system generation program. 

You write all the catalog statements in the usual way — using SYS1 as the 
qualifier for each entry in the catalog. (The qualifier you supply is only 
used in the DD statements — never in the CATLG statements.) When the system 
generation process has been completed, the catalog and the system data sets 
for the new system are ready to be used. 

Figure 19 contains an example of an input deck for allocating and cataloging 
the system data sets for a new system that will be located on one volume. 
A user-supplied qualifier of 'X* has been assumed. The INDEX keyword parameter 
in the GENERATE macro instruction will be coded as INDEX=X. 



//ALLOC 


JOB 


//STEP 


EXEC 


//SYSPRINT 


DD 


//JOBQE 


DD 


// 




//SVCLIB 


DD 


// 




// 




//LINKLIB 


DD 


// 




// 




//CATALOG 


DD 


// 




// 




//PROCLIB 


DD 


// 




// 




//PARMLIB 


DD 


// 




// 




//IMAGELIB 


DD 


// 




// 





ACCNT, PROGRAMMER, MSGLEVEL=1 -ONE VOLUME- 

PGM= IEHPROGM 

SYSOUT=A 

DSNAME=SYS1 . SYSJOBQE, VOLUME= (, RETAIN, SER= 11111!) 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (250) ,,CONTIG) 

DSNAME=X.SVCLIB,VOLUME=(,RETAIN,SER=111111) , 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (175,, 100)) , 



LABEL=EXPDT=98365,DCB=(DSORG=POU,RECFM=U,BLKSIZE=1024) 

DSNAME=X.LINKLIB,?OLUME=(,RETAIN,SER=1111 11) , X 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (8 90,5 0, 100) ) , X 
LABEL=EXPDT=98365,DCB=(RECFM=U,BLKSIZE=3625) 

DSNAME=SYSCTLG,VOLUME=(,RETAIN,SER=1111 11), X 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (3,10)) , X 
LABEL=EXPDT=98365 

DSNAME=X. PROCLIB, VOLUME=(, RETAIN, SER=111111) , X 

UNIT=231 1,DISP=(,KEEP) ,SPACE=(TRK, (35,5,7)) , X 
LABEL=EXPDT=98365,DCB=(RECFM=FB,BLKSIZE=3360) 

DSNAME=X.PARMLIB,VOLUME=(,RETAIN,SER=111111) , X 

UNIT=231 1,DISP=(,KEEP) ,SPACE=(TRK, (3,, 1) ) , X 
LABEL=EXPDT=98365,DCB=(RECFM=F,BLKSIZE=80) 

DSNAME=X.IMAGELIB,VOLUME=(,RETAIN,SER=111111) , X 

UNIT=231 1,DISP=(,KEEP) , SPACE= (TRK, (3, ,2) ) , X 
LABEL=EXPDT=98365,DCB=(RECFM=U,BLKSIZE=1024) 



Figure 19 (Part 1 of 2) . 
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//FORTLIB 

// 

// 

//SORTLIB 

// 
// 

//PL 1 LIB 

// 

// 

//NUCLEUS 

// 

// 

//SYSIN DD 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 

/* 



DD DSNAME=X. FORTLIB, VOLUME 
UNIT=231 1,DISP=(,KEEP) , 
LABEL=EXPDT=98365, DCB= ( 

DD DSNAME=X. SORTLIB, VOLUME 
UNIT=231 1,DISP=(,KEEP) , 
LABEL=EXPDT=98365, DCB= ( 

DD DSNAME=X.PL1LIB,VOLUME= 
UNIT=231 1,DISP= (, KEEP) , 
LABEL=EXPDT=98365,DCB= ( 

DD DSNAME=X. NUCLEUS, VOLUME 
UNIT=2311,DISP=(,KEEP) , 
LABEL=EXPDT=98365 



= (, RETAIN, SER=1 11111) , 

SPACE=(TRK, (4 5,5,30)) , 

RECFM=U,BLKSIZE=3625) 

= (, RETAIN, SER=111111) , 

SPACE= (TRK, (75, 10, 45) ) , 

RECFM=F,BLKSIZE=3625) 

(, RETAIN, SER= 111111) , 

SPACE=(TRK, (100,10,100)) , 

RECFM=U,BLKSIZE=3625) 

= (, RETAIN, SER=111 111), 

SPACE=(TRK, (30, ,1)) , 



DSNAME=S YS 1 . FORTLIB, VOL= 23 1 
DSNAME=SYS1.LINKLIB,V0L=231 
DSNAME=SYS1 . PARMLIB, V0L=23 1 
DSNAME=SYS1. IMAGELIB, V0L=23 
DSNAME=SYS1.PL1LIB,V0L=2311 
DSNAME=SYS 1 . PROCLIB, VOL=231 
DSNAME=SYS1. SORTLIB, VOL=231 
DSNAME=SYS 1 . SVCLIB, VOL=23 1 1 
DSNAME=SYS1.SYSJ0BQE,V0L=23 




11 

11 

11 

111 

1 

11 

11 

1 

111 



Figure 19 (Part 2 of 2) . 
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Allocating and Cataloging the Utility Data Sets 



You must also allocate space for and catalog five utility data sets in your 
operating system by means of JCL statements in your system generation input 
deck. (Detailed information about specifying these data sets is found in 
"Input Deck for System Generation" in this section.) 

Four of these data sets must be sequential data sets and are used by the 
assembler, the linkage editor, and the utility programs during system 
generation. The fifth data set must be a partitioned data set and is used 
for the storage of object modules assembled during system generation. Two 
of the sequential data sets and the partitioned data set must reside on a 
direct-access volume. 



Restoring the Data Set Names in the Starter Operating System 

After the system generation process has been completed, you should restore 
the names of the renamed data sets in the starter operating system. Also, 
uncatalog all the catalog entries in the generating system catalog that are 
no longer required. You can use either of the three utility programs (UNCT2311, 
UNCT2314, or UNCT3330) to do this, depending on which starter operating system 
package you used. 
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System Generation Using the Starter Operating System 

IBM provides an MFT starter operating system that can be used for the first 
system generation. The starter operating system must be initialized and made 
operational before it can be used as a generating system. The starter operating 
system and the procedures required to initialize it are described in this 
section. 

THE STARTER OPERATING SYSTEM PACKAGE 

The starter operating system package consists of an operating system and a 
set of libraries. This operating system includes: 

Control program 

Data set utilities 

System utilities 

Assembler F 

Linkage Editor F 

n addition to the operating system, the starter operating system package 
ncludes the following libraries: 

SYS1.SAMPLIB (sample library) — The members of the sample library are 
the sample programs used to test operating system components, and are 
usually kept in card decks by the installation. They are described in 
the "Testing the New System" section. Also included are: 

The independent utility programs IBCDASDI, IBCDMPRS, and ICAPRTBL. 

The IPL program IEAIPLOO. 

An example of how to write an accounting routine (SAMACTRT) . 

The system management facilities (SMF) sample programs, which, although 
in the sample library, are documented in OS SMF. 

CTLG2311, CTLG2314, and CTLG3330: When your operating system is being 
used as the generating system and a user-supplied qualifier is specified 
in the INDEX keyword parameter of the GENERATE macro instruction, this 
utility program can be used to prepare the 2311, 2314, or 3330 distribution 
of the starter operating system for the system generation process. 
SYS1.GENLIB, SYS1.MODGEN, SYS 1. MODGEN2, and the component libraries are 
cataloged in the generating system. Seven libraries (COBLIB, FORTLIB, 
MACLIB, PARMLIB, PL1LIB, PROCLIB, and SORTLIB) are cataloged in the 
generating system and renamed to SYS 1 .DCOBLIB, SYS1. DFORTLIB, SYS 1. DMACLIB, 
SYS1.DPARMLIB, SYS1 . DPL1LIB, SYS 1 . DPROCLIB, and SYS1 . DSORTLIB. 

UNCT2311, UNCT2314, and ONCT3330: These utility programs should be used 
after the system generation process is over if the CTLG2311, CTLG2314, 
or CTLG3330 utility programs were used. This utility program uncatalogs 
SYS1.GENLIB, SYS1.MODGEN, SYS 1 . MODGEN2, and the component libraries from 
the starter operating system. It also uncatalogs and restores the names 
of the seven system libraries that were renamed. 

Component libraries. 

SYS1.GENLIB (Stage I generation library) — This library has a blocking 
factor of 42. 
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SYS1.M0DGEN and SYS1.M0DGEN2 (Stage II generation libraries) — Each library 
has a blocking factor of 42. 

SYS1.PARMLIB (parameter library) — This library is unblocked. 

SYS1.PR0CLIB (cataloged procedures library) — This library is unblocked. 

SYS1.MACLIB (macro library) — This library has a blocking factor of 42. 

SYS1.C0BLIB (COBOL library). 

SYS1.F0ETLIB (FORTRAN library) — This library is distributed without 
members. 

SYS1.PL1LIB (PL/I library) . 

SYS1.S0RTLIB (sort library). 

SYS1.TS0MAC (TSO macro library) — This library has a blocking factor of 
45. 

SYS1.TCAMMAC (TCAM macro library) — This library has a blocking factor 
of 45. 

SYS1.TS0GEN (Stage II generation library) — This library has a blocking 
factor of 45. 

SYS1.D0ADS (TSO user attribute data set). 

SYS1.DHELP (TSO help data set). 

SYS1.DCMDLIB (TSO command library). 

SYS1.DN554A (service aids library) — This library has a blocking factor 
of 45. It contains an independent service aid program called IMCJQDMP. 
Information on the retrieval and use of IMCJQDMP is provided in OS Service 
Aids. 



STARTER SYSTEM REQUIREMENTS 

The starter operating system contains a Release 21 level MFT control program 
that requires 128K bytes of main storage. Figure 20 shows the maximum machine 
configuration supported by the starter system. Any subset of this configuration 
can be used if it meets the minimum requirements shown in Figure 21. The 
device types that can be used are listed in Figure 22 and the group names that 
support the IBM-supplied cataloged procedures are provided in Figure 23. 

All the devices to be used must be ready before IPL; any device not ready will 
automatically be taken off line. If a device that was not ready at IPL is 
required during a job step, the operator should enter a VARY ONLINE command 
for that device. 

When using the starter operating system, it is permissible to have devices 
other than those shown in Figure 20 attached to the system. However, an 
interruption must not be issued from any of these additional devices while 
the starter operating system is running. For example, the operator must not 
make any one of these devices ready. 
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STARTER SYSTEM SPECIAL CONSIDERATIONS 

Special considerations that apply only to the starter system are described 
as a guide. 

Multiple System Generations 

• When generating multiple systems, the MET starter system may require a 
larger system gueue area (SQA) than the generated 5K bytes. The SQA may 
be specified at IPL time, as explained in OS Operator's Reference manual. 
OS Storage Estimates manual explains how to determine the required SQA 
value, which must then be rounded to a doubleword boundary. 

• A larger SYS 1 .SYSJOBQE data set may also be required. How to change the 
size of this data set is explained in the "Restart Procedures" section 
of this manual under "SYS 1. SYSJOBQE Considerations." 



The Universal Character Set Feature 



If a system generation is performed using a 1403 printer with the universal 
character set feature, the BPS UCS utility program (360-UT-048) must be executed 
before system generation in order to load the read/write storage units. When 
the UCS program is executed, NO-FOLDING and BLOCK-DATA-CHECK must be specified. 
This program is described in the IBM System/360 Basic Programming Support; 
Universal Character Set Utility Program Operating Guide. 



Models 91 and 195 



If a system generation is done using a S/360 Model 9 1 or 195 central processing 
unit, the switch on the system control panel must be in the INHIBIT OVERLAP 
position. 



The M65MP System 

The starter operating system cannot operate on an M65MP configuration with 
unit record devices as input/output, but it can operate with tape input/output, 
If the starter operating system is used on another configuration, it can 
generate an operating system for the M65MP system. 



The 2305, 2314, or 3330 Direct-Access Storage 

The starter operating system will not work correctly if there is a two-channel 
switch on the 2305, 2314, or 3330 and one of the channels is not disabled. 

If 3330 devices are used, a single partition of at least 85K is used. 
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The Dual Density Feature and 9-Track Hagnetic Tape Drives 

For 9-track magnetic tape drives with or without the dual density feature, 
the starter operating system will assume a default value of 800 BPI. This 
applies whether the tape volumes mounted on the drives have standard labels 
or no labels. 

If, however, you desire to use 1600 BPI for the 9-track tape drives with or 
without the dual density feature, then you must specify the density in the 
DCB parameter of the DD statements for all the data sets that will reside on 
these drives. This applies if the tape volumes mounted on the drives have 
standard labels or no labels. 

Notes: 

• This density specification for 1600 BPI will not be passed on from one 
step of a job to the next. 

• 1600 BPI cannot be used for SISOUT. 



Model 95 

If a system generation is done using a Model 85 central processing unit, a 
1052 console with an address of 009, 01F, 209, 2 IF, or 309 must be attached 
to the system. The soft machine-check interrupt switch on the system control 
panel must be in the INHIBIT position. 



S/370 Model 165 or 168 

If a system generation is done using a Model 165 or 168 central processing 
unit, a 1052 console with an address of 009, 01F, 209, 21F, or 309 must be 
attached to the system. 
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1052 
Console 
"009 



Mpx 
Channel 



S/360 
Model 40, 50, 65, 75, 85, 91 , 195, or 67 in 65 mode 
S/370 
Model 135, 145, 155, 158, 165, 168, or 195 



Selector 
Channel 3 



1052 
Console 




3211 
Printer 
I 002 




3811 
Control 





3211 
Printer 
004 



3811 
Control 



2301 

Drum 



2820 

Control 



2305-2 
FHSF 



1D0 




vJH3 vJ13 



Tape 
Control 



,H ^ 2 400 ) 

vis 




A 2303 may be substituted for any one of the 
231 1's attached to the 2841 Storage Controls 
on Selector Channel 1 and Channel 2. The 
2303 addresses will be 197 and 297. 
These tapes must be 7 track tape units with 
the data conversion feature. All others must 
be 9 track tape units. Addresses 180 to 184 
and 280 to 284 may be replaced with 3400 
series tape drives. If the 3400 series tape 
drives are to be used and 2400 devices are 
not available, UNIT=2400 should be 
specified for the 3400 tape drives. 

Can be a 3210 or 3215 printer keyboard, except with S/370 Model 165. 



Tape 
Control 



2400 Y ( 2 400 V "* * 
180| \ ^f280| " 



2400 
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2400 

[281 



((--■/2 4O0Y 

Ah 

<> f 2 400 ) 

( 2 400 ) 



(240oVh, 
V 1 282 I 

( 2 400 >- H > 
\j283j 

[ 2400J-— 

Mill 



2821 
Control 



2540 
Reader 



2540 
Punch 



1403 
Printer 

Hoe 



2820 
Control 



2301 
Drum 
2C0 



2305-2 
FHSF 



2D0 




Figure 20. Maximum System Configuration for the Starter Operating System 
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Minimum 
Requirement 


Function 


Choose from the following 


Device 


Device Address 


MPX 
Channel 


Selector 
Channel 1 


Selector 
Channel 2 


Selector 
Channel 3 


1 


System Console 


1052, 3210, or 3215 


009, 01F 




209.21 F 


309 


3213 


011, 015 








3158 


010,014 








1 


System Input 


2540 Reader 


OOC 




20C 




3505 Reader 


012 








3525 Card Punch 


013 








1442 Read Punch 1 


00A 




20A 




2400 (7 Tr-DC) 




180, 181 


280, 281 




2400 (9-Track) 




182, 183, 184 


282, 283, 284 




1 


Punch Output 


2540 Punch 


00D 




20D 




1442 Read Punch 1 


00A 




20A 




3525 Card Punch 


013 








2400 (7 Tr-DC) 




180, 181 


280, 281 




2400 (9-Track) 




182, 183, 184 


282, 283, 284 




1 


Print Output 


1443 


00B 




20B 




1403 


00E,00F 




20E 




3211 


002,004 








2400 (7 Tr-DC) 




180, 181 


280, 281 




2400 (9-Track) 




182, 183, 184 


282, 283, 284 




1 


DLIB01 


2311 




190, 191, 192, 193 


290,291,292,293 




2314 




130, 131, 132, 133, 
134, 135 


230,231,232,233, 
234, 235 


330,331,332,333 


3330 




150, 151, 152, 153 


250,251,252, 253 


350,351, 352,353 


1 


DLIB02 


2311 




190, 191,192,193 


290,291,292,293 




2314 




130, 131, 132, 133, 
134, 135 


230,231,232,233, 
234, 235 


330,331,332,333 


1 


DLIB03 


2311 




190, 191, 192, 193 


290.291,292,293 




1 


DLIB04 


2311 




190, 191, 192, 193 


290,291,292,293 




1 


DLIB05 


2311 




190, 191,192, 193 


290,291,292,293 




1 


OLIB06 2 


2311 




190,191,192,193 


290, 291 , 292, 293 




1 


New System 


2311 




190, 191, 192, 193 


290,291,292,293 




2301 




1C0 


2C0 




2303 




197 


297 




2314 




130, 131, 132. 133, 
134, 135 


230,231,232,233, 
234, 235 


330,331, 332,333 


2305-1 




1F0 


2F0 




2305-2 




1D0 


2D0 




3330 




150, 151, 152, 153 


250, 251, 252, 253 


350, 351, 352, 353 


2 3 


System generation 
utility data sets 


2311 




190, 191, 192, 193 


290,291,292,293 




2301 




1C0 


2C0 




2303 




197 


297 




2314 




130, 131, 132, 133, 
134, 135 


230,231,232,233, 
234, 235 


330,331. 332, 333 


2305-1 




1F0 


2F0 




2305-2 




1D0 


2D0 




3330 




150, 151, 152, 153 


250, 251,252, 253 


350,351,352,353 


2400 (9-Track) 




182, 183, 184 


282, 283, 284 




1 A single 1442 may serve as either system input or punch output, but not both simultaneously. 

o 

For TSO systems. 

"* The system generation utility data sets do not require additional direct access devices if sufficient space is available on the volumes that 
contain the starter system and the new system, (see "Input Deck for System Generation" in the section "Preparation for System 
Generation".) 



Figure 21. Minimum I/O Requirements 
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Magnet: 


ic Tape 


Drives 




Device 


Type 




2400 






2400-2 






3400 






3400-2 





Description 

2400 series 9 -track magnetic tape drive 

2400 series magnetic tape drive with seven track 

compatibility and data conversion 

3400 series 9-track magnetic tape device, 800 or 

1600 bpi only 

3400 series magnetic tape drive with seven track 

capability and data conversion 



Direct-Access Devices 
Device Type 
2311 
2301 
2303 
2305-1 
2305-2 
2314 
3330 

Unit Record Equipment 
Device Type 
T051 
1403 
1442 
1443 
2540 
2540-2 
3210 
3211 
3213 
3215 
3505 
3525 



Description 

2311 disk storage drive 

2301 drum storage 

2303 drum storage 

2305 fixed-head disk storage Model 

2305 fixed-head disk storage Model 

2314 disk storage facility 

3330 disk storage facility 



Description 

1052 printer keyboard 

1403 printer 

1442 serial reader punch 

1443 printer 

2540 reader punch (read feed) 

2540 reader punch (punch feed) 

32 10 console printer keyboard 

3211 printer 

3213 console printer no keyboard 

3215 console printer keyboard 

3505 card reader 

3525 card punch with read and print feature 



Figure 22. Device Types 



Name Function 

SYSSQ Sequential access on devices at any of the following addresses: 182, 
183, 184, 282, 283, 284, 190, 191, 192, 193, 290, 291, 292, 293 (any 
9-track tape or 2311 disk storage drive). 

SYSDA Direct access on devices at any of the following addresses: 190, 191, 
192, 193, 290, 291, 292, 293, (any 2311); 1C0, 2C0, (any 2301); 197, 
297, (any 2303); 1D0, 1F0, 2D0, 2F0, (any 2305); 130, 131, 132, 133, 
134, 135, 230, 231, 232, 233, 234, 235, 330, 331, 332, 333, (any 
2314); 150, 151, 152, 153, 250, 251, 252, 253, 350, 351, 352, 353, 
(any 3330) . 

SYSCP A 2540 card punch at address 0OD or 20D, or 1442 at address 00A or 20A, 
or 3525 at address 013. 

Figure 23. Additional Group Names Supporting IBM-Supplied Cataloged Procedures 
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PROCESSING THE STARTER PACKAGE 

Before the starter operating system package can be used for system generation, 
it must be initialized and prepared for use. If the package is on tape, 
preparation consists of: 

1. Restoring the system to disk (the tape then becomes a backup copy of the 
system) . 

2. Punching the independent utility programs and the sample programs from 
SYS1.SAMPLIB for later use. 

3. Listing the data describing the system. 

If the starter operating system package is on disk, preparation consists of: 

1. Punching the independent utility programs and the sample programs from 
SYS1.SAMPLIB for later use. 

2. Creating a backup copy of the system on disk or tape. 

3. Listing the data describing the system. 

Processing of the tape or disk distribution of the starter operating system 
package is depicted in Figure 24. Detailed processing instructions are 
contained in the procedure section that follows. 
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Figure 24. Processing the Starter Package 
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PROCEDURES FOR PROCESSING THE STARTER PACKAGE 



This section contains detailed procedures for processing the various types 

of starter operating system packages and for deleting libraries from the starter 

operating system. Procedures are given for: 

Complete 2311 package — tape distribution 

Complete 2311 package — disk pack distribution with tape backup 

Complete 2311 package — disk pack distribution with disk pack backup 

Complete 2314 package — tape distribution 

Complete 3330 package — tape distribution 



In using these procedures, it may be helpful to refer to Appendix C. This 
appendix describes the distribution methods and illustrates the arrangement 
of the starter package data sets on disk packs and tapes. 



The procedur 
underlined f 
installation 
in OS Utilit 



es include ex 
ields are tho 
s. Further e 
ies. Remembe 



you receive: 
DLIBC3, DLIB 
with the 231 
serial numbe 
DLIB01. 



a complete 
04, and DLIBO 
1 package if 
rs DLIBO 1 and 



amples of control decks. In these examples, the 
se that may reguire modification for different 
xplanation of the field reguirements is contained 
r to tailor the control decks for the distribution 
2311 package uses volume serial numbers DLIBO 1, DLIB02, 
5; the volume serial number DLIB06 must be ordered 
TSO is to be generated; a 2314 package uses volume 
DLIB02; and a 3330 package uses volume serial number 



For illustrative purposes, the given procedures assume the set of devices and 
device addresses listed in Figure 25. 



Device Function 

Printer Keyboard 
System Residence and 
System Data Sets 

• DLIBO 1 

• DLIB02 

• DLIB03 

• DLIB04 

• DLIB05 

• DLIB06 
System Input 
Punch Output 
Print Output 
Tape Drives 1 



Input/Output Device 
1052 



Address 



01F 



2311 (2314 or 


3330) 


190 (130 or 150) 


231 1 (or 2314) 




191 (or 131) 


2311 




192 


2311 




193 


2311 




290 


2311 




291 


2540 reader 




OOC 


2540 punch 




00D 


1403 printer 




00E 


2400 tape 




1802 


2400 tape 




1812 


2400 tape 




1822 



iTape units are required only if the starter package is received on tape or 
if system backup is created on tape. 

2 Tape units located at addresses 180 and 181 are 7-track tape units with the 
data conversion feature. The tape unit at 182 is a 9-track tape unit. 

Figure 25. Sample Configuration 
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2311 Package — Tape Distribution 

The procedure for processing the tape distribution of the 2311 starter operating 
system package is as follows: 



Initialize Disk 

1. Mount the disk pack onto which DLIB01 is to be restored. 

2. Mount tape #1 (DLIB01) of starter package. 

3. Load IBCDASDI program from tape by setting the load selector switches and 
pressing the console LOAD key. When the program is loaded, the wait state 
is entered and the hexadecimal value FFFF is displayed in the console 
lights. 

4. Place the following control deck in the input device to initialize the 
disk: 

JOB 

MSG TOD5V= 1403, TOADDR=00E 

DADSF TODEV=2311,TOADDR= 190, VOLID= SCRATCH,FLAGTEST=NO 

VLD NEWVOLID= 1 11111, OWNERID =DEPT38 

VTOCD STRTADR=5fl,EXTENT=10 

END 

In the DADEF statement, the FLAGTEST= NO parameter must be used only when 
the disk is initialized for the first time. 

Note: The VTOCD statement creates a temporary VTOC. 

5. Define the control statement input device by pressing the REQUEST key of 
the printer keyboard. The message DEFINE INPUT DEVICE will be printed. 
Enter the message INPUT=xxxx cuu where, xxxx is the device type, c is the 
channel address, an uu is the unit address. The device type can be 1442, 
2400, or 2540. 

6. When the disk initialization is complete, the message END OF JOB is printed 
on the nfessage output device, and the program enters the wait state. 

Restore Tape to Disk 

7. Load the IBCDMPRS program from tape by setting the load selector switches 
and pressing the console LOAD key. When the program is loaded, the wait 
state is entered and the hexadecimal value FFFF is displayed in the console 
lights. 
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8. Place the following deck in the input device to restore the contents of 
the tape to the disk: 

JOB 

MSG TODEV= 1403, TOADDR= 00E 

RESTORE FROMDEV=2400,FROMADDR=180_ C TODEV=2311, X 

TOADDR= 190, VOLID= 111111 
END 

when restoring is complete, the serial number of the disk has been changed 
from 111111 to DLIB01. 

9. Define the control statement input device by pressing the REQUEST key of 
the printer keyboard. The message DEFINE INPUT DEVICE will be printed. 
Enter the message INPUT=xxxx cuu, where xxxx is the device type, c is the 
channel address, and uu is the unit address. The device type can be 1442, 
2400, or 2540. 

10. When the restoring is complete, the message END OF JOB is printed on the 
message output device, and the program enters the wait state. 

Initialize and Restore Second Disk 

11. The unit to be initialized must be in an offline status. Carry out the 
IPL procedure (the steps denoted with an **) from the disk restored in 
Steps 1 through 10 with the following control deck in the input device: 

// VARY 191, OFFLINE 

//DLIB02 JOB ACCT123, PROGRAMMER, MSGLEVEL=1 

//INIT02 EXEC PGM=IEHDASDR,PARM=»N=1 f 

//SYSPRINT DD SYS0UT=A 

//SYSIN DD * 

ANALYZE TODD = 191, V TOC=00004 , EXTENT=000 1 , FLAGTEST=NO, X 

N EW VOL ID= DLIB02 
/* 

// VARY 191, ONLINE 
//REST02 EXEC PGM=IEHDASDR,PARM=« N=1 • 

SYSOUT=A 

UNIT= 180, DISP=OLD,LABEL=(4,NL) , X 

VOLUME=SER=REST02 

ONIT- 191, DISP=OLD,VOLgME=SER=DLIB02 

* 



//SYSPRINT 


DD 


//FROM0 2 


DD 


// 




//DLIB02 


DD 


//SYSIN 


DD 


RESTORE 



FROMDD=FROM02,TODD =DLIB02, CPYVOLID=YES, 
PURGE=YES 



/* 



Initialize and Restore Third, Fourth, Fifth, and Sixth Disks 



12. Repeat Step 11 to initialize and restore DLIB03 and DLIB04. If the 

distribution was on three 800-BPI tapes, the first half of DLIB03 is on 
the first tape. The second half of DLIB03 is on the second tape. The 
file number subparameter of the LABEL=(n,NL) is 6 for the first half of 
DLIB0 3 on Tape #1. The file number subparameters on the second tape are 
2 for DLIB03, and 4 for DLIB04. The file subparameters on the third tape 
are 2 for DLIB05 and 4 for DLIB06. DLIB06 is required only for a TSO 
generation. Repeat Step 11 to initialize and restore DLIB05 and DLIB06. 
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If the distribution was on two 1600-BPI tapes, the file count subparameter 
on the first tape will be 6 for DLIB03 and 8 for DLIB04. The file count 
subparameter on the second tape will be 2 for DLIB05 and 4 for DLIB06. 

Punch Utility and Sample Programs 



13. Completion of the preceding steps provides operable disk packs with backup 
tapes. Proceed to punch the independent utility programs and any sample 
programs desired. Be sure all necessary volumes are mounted and make ready 
all devices to be used. 

14. The following control deck should be placed in the input device; 

//J0B1 JOB ACCT123, PROGRAMMER, MSGLEVEL=1 

// EXEC PGM=IEBPTPCH 

//SYSDT1 DD DSNAME=SYS1.SAMPLIB,DISP= (OLD, KEEP) 

//SYSUT2 DD UNIT =2540-2 

//SYSPRINT DD SYSOOT=A 

//SYSIN DD * 

PUNCH TYP0RG=P0,MAXNAME=4 

MEMBER NAME=IBCDMPRS 

MEMBER NAME=IBCDASDI 

MEMBER NAME=IEAIPL00 

MEMBER NAME=IBCRCVRP 
/* 

A MEMBER card should be added to the above control deck for each sample 
program desired for later use, and for SAMACTRT provided the MAXNAME field 
in the PUNCH control card is adjusted to show the revised number of member 
cards in the deck. The member name card (first card) should be removed 
from each member deck punched. (Refer to the "Testing the New System" 
section of this publication for names of the sample programs.) 

15** Set the LOAD UNIT switches on the control panel to the channel, 
control unit, and device of the system-residence volume (DLIB01). 
Then press the LOAD key. 

16** Reply 00,'RAM=,« to the SPECIFY SYSTEM PARAMETERS message to comply with 
128K minimum configuration unless the 3330 or 2305 devices are being used, 
then reply 00, , RAM=01 I . Reply no to the reguest for a SYS 1. DUMP data set. 
Signal EOB to the SPECIFY SYSTEM PARAMETERS message. Reply no to the 
change partitions message. Wait for the READY message and for the WAIT 
light to be turned on. Then enter a SET command specifying the date, as 
follows: 

a. Press the REQUEST key. 

b. Wait for the READ light to go on. 

c. Type SET DATE=yy .ddd,Q= (,F) to specify date. 

d. Signal EOB. 

e. Reply U to the SPECIFY JOB QUEUE PARAMETERS message and 
wait for the WAIT light to go on. 
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17** Commands must be entered to start a SYSODT writer, a reader, and 
an initiator. It is recommended that the direct SYSOOT writer be 
used. The commands are: 

MN JOBNAMES 
START DSO.P1,OOE 
START RDR.S,00C 
START INIT.ALL 

If 00E and 00C are not the addresses of the writer and reader, 
enter the correct addresses. 

18** When the job is completed, a READER ENDED message will be printed, 
followed by a JOB ENDED message. The system will then enter the 
wait state. See the OS Operator's Reference for a discussion of 

stopping the system for MFT. 

List System Catalog 

19. In order to determine the location of the component libraries, 
place the control deck shown below in the input device. 

Then enter a START RDR.S,00C command. 

//LISTCTLG JOB ACCT 123, PROGRAMMER, MSGLEVEL= 1 

//STEPA EXEC PGM=IEHLIST 

//SYSPRINT DD SYSOUT=A 

//SYSRS DD UNIT=2311,DISP=(OLD,KEEP) , X 

// VOLUME=(, RETAIN, SER=DLIB01) 

//SYSIN DD * 

LISTCTLG 
/* 

Note: You must carry out the IPL procedure (the steps denoted with an 
**) if the preceding punch operation was skipped. 

List System Data 

20. To list the data describing the system, place the proper control deck shown 
below in the input device. 

Then enter a START RDR.S,00C command. 
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Control deck for users of the complete 2311 package: 



//J0B2 JOB 


//STEP1 EXEC 


//SYSPRINT DD 


//DD1 


DD 


//DD2 


DD 


//DD3 


DD 


//DD«* 


DD 


//DD5 


DD 


//DD6 


DD 


//SYSIN DD 




LISTVTOC 




LISTVTOC 




LISTVTOC 




LISTVTOC 




LISTVTOC 




LISTVTOC 




LISTPDS 




LISTPDS 




LISTPDS 




LISTPDS 




LISTPDS 




LISTPDS 




LISTPDS 



/* 



ACCT 123, PROGRAMMER ,M SGLE VEL= 1 

PGM=IEHLIST 

SYSODT=A 

UNIT=231 1,DISP=OLD,VOL0ME=SER=DLIBC1 

ONIT=2311,DISP=OLD,VOLUME=SER=DLIB02 

UNIT=231 1,DISP=OLD,VOL0ME=SER=DLIB03 

UNIT=2311,DISP=OLD,VOLUME=SER=DLIB04 

UNIT=231 1,DISP=OLD,VOLUME=SER=DLIB05 

UNIT=2311,DISP=OLD,VOLUME=SER=DLIB06 (if TSO) 

* 

DUMP 

DUMP,VOL=2311=DLIB02 

DDMP,VOL=231 1=DLIB03 

DUMP, VOL=23 1 1=DLIB04 

D0MP,VOL=231 1=DLIB05 

DUMP,VOL=2311=DLIB06 (if TSO) 

DSNAME=(SYS1.PROCLIB X 

[, Optional PDSs on System Residence]) 
VOL=2311=DLIB0 2,DSNAME=SYS1.MODGEN 
V0L=231 1=DLIB01,DSNAME=SYS1.MODGEN2 
VOL=231 1=DLIB03,DSNAME= (component library) X 
[ , component library. . . ]) 

VOL=2311=DLIB04,DSNAME=SYS1.GENLIB 

VOL=231 1=DLIB05,DSNAME= (component libraries) 

VOL=2311=DLIB06,DSNAME= (component library X 
[, component library. . . J) (if TSO) 



Specify the component libraries desired in the proper LISTPDS statement. 
In the list deck, any of the partitioned data sets shown in Figure 90 may 
be specified in the LISTPDS statement. 

Note: You must carry out the IPL procedure (the steps denoted with an 
**) if the preceding punch operation was skipped. 
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2311 Package — Disk Pack Distribution (Tape Backup) 

The procedure for processing the disk pack distribution of the 2311 starter 
operating system package, with tape backup, is as follows: 



Punch Utility and Sample Programs 

1. The disk packs are operable as received. Punch the independent utility 
programs (needed to create a tape backup copy of the disks) and any sample 
programs desired. Be sure all necessary volumes are mounted and make ready 
all devices to be used. 

2. The following control deck should be placed in the input device: 

//J0B1 JOB ACCT 123, PROGRAMMER, MSGLEVEL=1 

// EXEC PGM=IEBPTPCH 

//SYSUT1 DD DSNAME=SYS1.SAMPLIB,DISP= (OLD, KEEP) 

//SYSUT2 DD UNIT= 2540-2 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD * 

PUNCH TYP0RG=P0,MAXNAME=4 

MEMBER NAME=IBCDMPRS 

MEMBER NAME=IBCDASDI 

MEMBER NAME=IEAIPL00 

MEMBER NAME=IBCRCVRP 
/* 

A MEMBER card should be added to the above control deck for each sample 
program desired for later use, and for SAMACTRT, provided the MAXNAME field 
in the PUNCH control card is adjusted to show the revised number of member 
cards in the deck. The member name card (first card) should be removed 
from each member deck punched. (Refer to the "Testing the New System" 
section of this publication for names of the sample programs.) 

3. Set the LOAD UNIT switches on the control panel to the channel, 
control unit, and device of the system-residence volume (DLIB01). 
Then press the LOAD key. 

4** Reply no to the reguest for a SYS 1. DUMP data set. Signal EOB 

to the SPECIFY SYSTEM PARAMETERS message. Reply no to the change 
partitions message. Wait for the READY message and for the 
WAIT light to be turned on. Then enter a SET command specifying 
the date, as follows: 

a. Press the REQUEST key. 

b. Wait for the READ light to go on. 

c. Type SET DATE=yy.ddd to specify date. 

d. Signal EOB. 

e. Reply U to the SPECIFY JOB QUEUE PARAMETERS message and 
wait for the WAIT light to go on. 



48 OS System Generation 



5** Commands must be entered to start a SYSOOT writer, a reader, and an 

initiator. It is recommended that the direct SYSOUT writer be used. The 
commands are: 

HN JOBNAMES 
START DSO.P1,OOE 
START RDR.S,00C 
START INIT.ALL 

If 00E and 00C are not the addresses of the writer and reader, the user 
should enter the correct addresses. 

6** When the job is completed, a READER ENDED message will be printed, followed 
by a JOB ENDED message. The system will then enter the wait state. See 
the OS Operator's Reference for a discussion of stopping the system for 

MFT. 



Dump Disk to First Tape 



7. Place the TBCDMPRS program (punched from SYS1.SAMPLIB in Step 2) in the 
input device, followed by the control deck shown below. 

JOB 

MSG TODEV= 14 03, TOADDR=00E 

DUMP FRO«DEV=2311,FROMADDR= 190, X 

TODEV=2400,TOADDR=18J_ 
END 

8. Mount the tape that is to contain the backup copy of the first disk pack 
(DLIB01) . 

9. Load the IBCDMPRS program by setting the load selector switches and pressing 
the console LOAD key. When the program is loaded, the wait state is entered 
and the hexadecimal value FFFF is displayed in the console lights. 

10. Define the control statement input device by pressing the REQUEST key of 
the printer keyboard. The message DEFINE INPDT DEVICE will be printed. 
Enter the message INPUT=xxxx cuu, where xxxx is the device type, c is the 
channel address, and uu is the unit address. The device type can be 1442, 
2400, or 2540. 

11. After the dump to tape is completed, an END OF JOB message will be printed 
and the program will enter the wait state. The tape should be removed 
and stored in the tape library. 

Dump Second Disk to Second Tape 

12. Repeat Steps 7 through 11 to dump the contents of disk pack DLIB02. 



Dump Third Disk to Third Tape 



13. Repeat Steps 7 through 11 to dump the contents of disk pack DLIB03. 
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Dump Fourth Disk to Fourth Tape 



14. Repeat Steps 7 through 11 to dump the contents of disk pack DLIB04. 



Dump 


Fifth 


Disk 


to 


Fifth 


Ta 


pe 


















15. ] 


Repeat 


Steps 7 


throuc 


Jh 


11 


to 


dump 


the 


contents 


of 


disk 


pack 


DLIB05. 


Dump 


Sixth 


Disk 


to 


Sixth 


Ta 


pe 



















16. Repeat Steps 7 through 11 to dump contents of disk pack DLIB06. (Reguired 
only for TSO systems.) 

List System Catalog 



17. In order to determine the location of the component libraries, place the 
control deck shown below in the input device: 

Then enter a START RDR.S,00C command. 

//LISTCTLG JOB ACCT 123 , PROGRAMMER, MSGLEVEL= 1 

//STEPA EXEC PGM=IEHLIST 

//SYSPRINT DD SYSOOT=A 

//SYSRS DD UNIT=231 1,DISP= (OLD, KEEP) , X 

// VOLUME=(, RETAIN, SER=DLIB01) 

//SYSIN DD * 

LISTCTLG 
/* 

Note: You must carry out the IPL procedure (the steps denoted with an 
**) if the preceding dump operation was performed. 
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List System Data 



To list the data describing the system, load the operating system, and 
place the proper control deck shown below in the input device: 

Then enter a START RDR.S,00C command. 

Control deck for users of the complete 2311 package: 

ACCT 123, PROGRAMMER, MSGLEVEL= 1 
PGM=IEHLIST 

SYSOUT=A 

UNIT=2311,DISP=OLD,VOLUME=SER=DLIB01 

DNIT=231 1,DISP=OLD,VOLUME=SER=DLIB0 2 

0NIT=231 1,DISP=OLD,VOLUME=SER=DLIB03 

UNIT=2311,DISP=OLD,VOLUME=SER=DLIB04 

UNIT=2311,DISP=OLD,VOLUME=SER=DLIB05 

UNIT=2311,DISP=OLD,VOLOME=SER=DLIB06 (if TSO) 

* 

DUMP 

DUMP,VOL=2311=DLIB02 

DUMP,V0L=231 1=DLIB03 

DUMP,VOL=231 1=DLIB04 

DUMP,V0L=231 1=DLIB05 

DUMP,VOL=231 1=DLIB06 

DSNAME= (SYS 1 . PROCLIB 

[, Optional PDSs on System 
LISTPDS VOL=2311=DLIB02, 

DSNAME=SYS1.M0DGEN 
LISTPDS VOL=231 1=DLIB0 1 , DSNAME=SYS 1 . MODGEN2 
LISTPDS VOL=2311=DLIB03,DSNAME= (component library 

[, component library...]) 
LISTPDS VOL=2311=DLIB04,DSNAME=SYS1.GENLIB 
LISTPDS VOL=231 1-DLIB05,DSNAME= (component libraries) 
LISTPDS VOL=2311=DLIB06,DSNAME= (component library 

[, component library...]) (if TSO) 
/* 



//JOB2 JOB 


//STEP1 EXEC 


//SYSPRINT DD 


//DD1 


DD 


//DD2 


DD 


//DD3 


DD 


//DD4 


DD 


//DD5 


DD 


//DD6 


DD 


//SYSIN DD 




LISTVTOC 




LISTVTOC 




LISTVTOC 




LISTVTOC 




LISTVTOC 




LISTVTOC 




LISTPDS 



(if TSO) 

Residence]) 



Specify the component libraries desired in the proper LISTPDS statement. 
In the LIST deck, any of the partitioned data sets shown in Figure 90 may 
be specified in the LISTPDS statement. 

Note: You must carry out the IPL procedure (the steps denoted with an 
**) if the preceding dump operation was performed. 
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2311 Package — Disk Pack Distribution (Disk Backup) 

The procedure for processing the disk pack distribution of the 2311 starter 
operating system package, with disk backup, is as follows: 



Punch Utility and Sample Programs 

1. The disk packs are operable as received. Punch the independent utility 
programs (needed to create a disk backup copy of the disks) and any sample 
programs desired. Be sure all necessary volumes are mounted and make ready 
all devices to be used. 

2. The following control deck should be placed in the input device: 

//J0B1 JOB ACCT 123, PROGRAMMER, MSGLEVEL=1 

// EXEC PGM=IEBPTPCH 

//SYSUT1 DD DSNAME=SYS1.SAMPLIB,DISP=(0LD,KEEP) 

//SYSUT2 DD UNIT= 25aO~2 

//SYSPRINT DD SYSOOT=A 

//SYSIN DD * 

PUNCH TYPORG=PO,MAXNAME=a 

MEMBER NAME=IBCDMPRS 

MEMBER NAME=IBCDASDI 

MEMBER NAME=IEAIPL00 

MEMBER NAME=IBCRCVRP 
/* 

A MEMBER card should be added to the above control deck for each sample 
program desired for later use, and for SAMACTRT, provided the MAXNAME field 
in the PUNCH control card is adjusted to show the revised number of member 
cards in the deck. The member name card (first card) should be removed 
from each member deck punched. (Refer to the "Testing the New System" 
section of this publication for names of the sample programs.) 

3** Set the LOAD UNIT switches on the control panel to the channel, 
control unit, and device of the system-residence volume (DLIB01) . 
Then press the LOAD key. 

4** Reply no to the request for a SYS 1. DUMP data set. Signal EOB 
to the SPECIFY SYSTEM PARAMETERS message. Reply no to the 
change partitions message. Wait for the READY message and for 
the WAIT light to be turned on. Then enter a SET command 
specifying the date, as follows: 

a. Press REQUEST key. 

b. Wait for READ light to go on. 

c. Type SET DATE=yy .ddd, Q= (,F) to specify date. 

d. Signal EOB. 

e. Reply U to the SPECIFY JOB QUEUE PARAMETERS message and 
wait for the WAIT light to go on. 
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5** Commands must be entered to start a SYSOUT writer, a reader, and 
an initiator. It is recommended that the direct SYSOUT writer be 
used. The commands are: 

MN JOBNAHES 
START DSO.P1,OOE 
START RDR.S,00C 
START INIT.ALL 

If 00E and 00C are not the addresses of the writer and reader, enter the 
correct addresses. 

6** When the job is completed, a READER ENDED message will be printed, followed 
by a JOB ENDED message. The system will then enter the wait state. See 
the OS Operator 1 s Reference for a discussion of stopping the system for 
MFT. 



Initialize Backup Disk 



7. Place the IBCDASDI program (punched from SYS1.SAMPLIB in Step 2) in the 
input device, followed by the control deck shown below: 

JOB 

MSG TODEV= 1403, TOADDR=00E 

DADEP TODEV-2311,TOADDR= 190, VOLID= SCRATCH r FLAGTEST=NO 

VLD NBWVOLID= 11 1 1 1 1, OWNERID= DEPT38 

VTOCD STRTADR=50,EXTENT=10 

END 

In the DADEF statement, the FLAGTEST=NO parameter must be used only when 
the disk is initialized for the first time. 

8. Mount the disk pack that is to receive the backup copy of the first starter 
disk pack (DLIB01) . 

9. Load the IBCDASDI program by setting the load selector switches and pressing 
the console LOAD key. When the program is loaded, the wait state is entered 
and the hexadecimal value FFFF is displayed in the console lights. 

10. Define the control statement input device by pressing the REQUEST key of 
the printer keyboard. The message DEFINE INPUT DEVICE will be printed. 
Enter the message INPUT=xxxx cuu, where xxxx is the device type, c is the 
channel address, and uu is the unit address. The device type can be 1442, 
2400, or 2540. 

11. When the disk initialization is completed, the message END OF JOB is printed 
on the message output device, and the program enters the wait state. 
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Restore Backup Disk 



12. Place the IBCDMPRS program (punched from SYS1.SAMPLIB in Step 2) in the 
input device, followed by the control deck shown below. 

JOB 

MSG TODEV= 1 403, TOADDR=00E 

DUMP FROMDEV=231 1 ,FROMADDR= 190 r TODEV=23 1 1 , X 

TOADDR= 191, VOLID= 111111 

END 

When restoring is completed, the serial number of the disk has been changed 
from 111111 to DLIB01. 

13. Load the IBCDMPRS program by setting the load selector switches and pressing 
the console LOAD key. When the program is loaded, the wait state is entered 
and the hexadecimal value FFFF is displayed in the console lights. 

14. Define the control statement input device by pressing the REQUEST key of 
the printer keyboard. The message DEFINE INPUT DEVICE will be printed. 
Enter the message INPUT=xxxx cuu, where xxxx is the device type, c is the 
channel address, and uu is the unit address. The device type can be 1442, 
2400, or 2540. 

15. When the dumping is completed, the message END OF JOB is printed on the 
message output device, and the program enters the wait state. 



Initialize and Restore Second Backup Disk 



16. Repeat Steps 7 through 15 to create a backup copy of the second disk pack 

(DLIB02) . 

Initialize and Restore Third Backup Disk 



17. Repeat Steps 7 through 15 to create a backup copy of the third disk pack 
(DLIB03) . 

Initialize and Restore Fourth Backup Disk 

18. Repeat Steps 7 through 15 to create a backup copy of the fourth disk pack 

(DLIB04) . 

Initialize and Restore Fifth Backup Disk 



19. Repeat Steps 7 through 15 to create a backup copy of the fifth disk pack 
(DLIB05) . 

Initialize and Restore Sixth Backup Disk 

20. Repeat Steps 7 through 15 to create a backup copy of the sixth disk pack 
(DLIB06) . (Reguired for TSO systems only.) 
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List System Catalog 



21. To determine the location of the component libraries, place the control 
deck shown below in the input device. 

Then enter a START RDR.S,00C command. 

//LISTCTLG JOB ACCT 123 , PROGRAMMER, MSGLEVEL= 1 

//STEPA EXEC PGM TEHLIST 

//SYSPRINT DD SYSODT=A 

//SYSRS DD UNIT=231 1,DISP (OLD, KEEP), X 

// VOLUME=(, RETAIN, SER=DLIB01) 

//SYSIN DD * 

LISTCTLG 
/* 

Note: You must carry out the IPL procedure (the steps denoted with an 
**) if the preceding initialization and restore operations were performed. 

List System Data 



22. To list the data describing the system, load the operating system and place 
the control deck shown below in the input device. 

Then enter a START RDR.S,00C command. Control deck for users of the 
complete 2311 package: 

ACCT 123, PROGRAMMER, MSGLEVEL= 1 
PGM=IEHLIST 
SYSOUT=A 

UNIT=2311,DISP=OLD,VOLUME=SER=DLIB01 
UNIT=231 1 ,DISP=OLD, VOLDME=SER=DLIB02 
UNIT=2311,DISP=OLD,VOLOME=SER=DLIB03 
DNIT=2311,DISP=OLD r VOLUME=SER=DLIB04 
UNIT=2311 r DISP=OLD,VOLDME=SER=DLIB05 
UNIT-2311,DISP=OLD,VOLUME=SER=DLIB06 (if TSO) 
* 

DUMP 

DOMP,VOL=2311=DLIB02 
DUMP,VOL=2311=DLIB03 
D0MP,V0L=231 1=DLIB04 
DUMP,VOL=231 1=DLIB05 
DUMP,VOL=2311=DLIB06 (if TSO) 

DSNAME=(SYS1.PROCLIB X 

[ , Optional PDSs on System Residence]) 
VOL=231 1=DLIB02,DSNAME=SYS1.MODGEN 
VOL=231 1=DLIB01,DSNAME=SYS1.MODGEN2 
VOL=2311=DLIB03,DSNAME= (component library X 
[, component library...]) 
VOL=2311=DLIB04,DSNAME=SYS1.GENLIB 
VOL=231 1=DLIB05,DSNAME= (component libraries) 
VOL=2311=DLIB06,DSNAME= (component library X 
[, component library...]) (if TSO) 
/* 



//JOB2 JOB 


//STEP1 EXEC 


//SYSPRINT DD 


//DD1 


DD 


//DD2 


DD 


//DD3 


DD 


//DD4 


DD 


//DD5 


DD 


//DD6 


DD 


//SYSIN DD 




LISTVTOC 




LISTVTOC 




LISTVTOC 




LISTVTOC 




LISTVTOC 




LISTVTOC 




LISTPDS 




LISTPDS 




LISTPDS 




LISTPDS 




LISTPDS 




LISTPDS 




LISTPDS 



Specify the component libraries desired in the proper LISTPDS statement. 
In the LIST deck, any of the partitioned data sets shown in Figure 90 may 
be specified in the LISTPDS statement. 

Note: You must carry out the IPL procedure (the steps denoted with an 
**) if the preceding initialization and restore operations were performed. 
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2314 Package — Tape Distribution 

The procedure for processing the tape distribution of the 2314 starter operating 
system package is as follows: 



Initialize Disk 

1. Mount the disk packs onto which DLIB01 and DLIB02 will be restored. 

2. Mount the tape distribution (DLIB01 and DLIB02) of the starter package. 
This is one 1600-BPI tape or two 800-BPI tapes. 

3. Load the IBCDASDI program from the tape by setting the load selector 
switches and pressing the console LOAD key. When the program is loaded, 
the wait state is entered and the hexadecimal value FFFF is displayed in 
the console lights. 

4. Place the following control deck in the input device to initialize the 

disk: 

JOB 

MSG TODEV= 1403, TOADDR =00E 

DADE? TODEV=2314,TOADDR= T50~, VOLID= SCRATCH,FLAGTEST=NO 

VLD NEWVOLTD= DLIB01, OWNERID= DEPT38 

VTOCD STRTADR=50_,EXTENT=10 

END 

JOB 

MSG TODEV= 1 403, TOADDR= 00E 

DADEF TODEV=2314,TOADDR= T3T, VOLID= SCRATCH,FLAGTEST=NO 

VLD NEWVOLID= DLIB02, OWNERID= DEPT38 

VTOCD STRTADR=50, EXTENT= 10 

END 

In the DADEF statement, the FLAGTEST=NO parameter must be used when the 
disk is initialized for the first time only. 

5. Define the control statement input device by pressing the REQUEST key of 
the printer keyboard. The message DEFINE INPUT DEVICE will be printed. 
Enter the message INPUT=xxxx cuu, where xxxx is the device type, c is the 
channel address, and uu is the unit address. The device type can be 1442, 
2400, or 2540. 

6. When the disk initialization is complete, the message END OF JOB is printed 
on the message output device, and the program enters the wait state. 



Restore Tape to Disk 

7. Load the IBCDMPRS program from tape by setting the load selector switches 
and pressing the console LOAD key. When the program is loaded, the wait 
state is entered and the hexadecimal value FFFF is displayed in the console 
lights. 

8. Place the following control deck in the input device to restore the contents 
of the tape to the disk: 

JOB 

MSG TODEV= 1 403, TOADDR =00E 

RESTORE FROMDEV=240 0,FROMADD?= 180, TODEV=2314, X 

TOADDR= 130, VOLID= DLIB01 
END 
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9. Define the control statement input device by pressing the BEQUEST key of 
the printer keyboard. The message DEFINE INPUT DEVICE will be printed. 
Enter the message INPUT=xxxx cuu, where xxxx is the device type, c is the 
channel address, and uu is the unit address. The device type can be 1442, 
2400, or 2540. 

10. When the restoring is completed, the message END OF JOB is printed on the 
message output device, and the program enters the wait state. 

The DLIB01 tape should be removed and stored in the tape library for backup 
purposes. 

Restore Second Tape to Disk 

11. (Do this step if you have two 800-BPI tapes. If you have a 1600-BPI tape, 
proceed to Step 12.) After pressing the LOAD key to skip over the IBCDASDI 
program, repeat Steps 7 through 10 to restore the contents of the tape 

to the disk. When this step is completed, there will be an operable disk 
pack with backup tape. 

12. You can now carry out the IPL procedure (the steps denoted with an **) 
with the DLIB01 volume and use it with the following deck to restore the 
DLIB02 volume. 

//DLIB02 JOB MSGLEVEL=1 



// EXEC 
//SYSPRINT DD 
//FROM DD 

// 

//TO DD 

//SYSIN DD 

RESTORE 

/* 



PGM=IEHDASDR,PARM= , N=T 

SYSOUT=A 

UNIT= 182, DISP=OLD,LABEL= (4,NL) , 

VOLUME=SER=REST02 

UNIT=13J_,DISP=OLD,VOLUME=SER=DLIB0 2 

* 

FROMDD=FROM,TODD=TO,CPYVOLID=YES, 
PURGE=YES 



If a 1600-BPI tape is used, the DLIB02 volume will be on the first tape. 
The file sequence number will be 4. 

Punch Utility and Sample Programs 

13. Completion of the preceding steps provides an operable disk pack with a 
backup tape. Punch the independent utility programs and any sample programs 
desired. Be sure the necessary volumes are mounted and make ready all 
devices to be used. 

14. The following control deck should be placed in the input device. 



//JOB 1 



JOB ACCT123, PROGRAMMER, MSGLEVEL=1 



// EXEC 
//SYSUT1 DD 
//SYSUT2 DD 
//SYSPRINT DD 
//SYSIN DD 
PUNCH 
MEMBER 
MEMBER 
MEMBER 
/* 



PGM=IEBPTPCH 

DSNAME=SYS1.SAMPLIB,DISP= (OLD, KEEP) 

UNIT =2540-2 

SYSOUT=A 

* 

TYPORG=PO,MAXNAME=4 
NAME=IBCDMPRS 
NAM E= IBCDASDI 
NAME=IEAIPL00 



Preparation for System Generation 57 



A MEMBER card should be added to the above control deck for the sample 
program desired for later use, and for SAMACTRT, provided the MAXNAME field 
in the PUNCH control card is adjusted to show the revised number of member 
cards in the deck. The member name card (first card) should be removed 
from each member deck punched. (Refer to the "Testing the New System" 
section of this publication for names of the sample programs.) 

15** Set the LOAD UNIT switches on the control panel to the channel, 
control unit, and device of the system-residence volume (DLIB01). 
Then press the LOAD key. 

16** Reply 00,'RAM=,» to the SPECIFY SYSTEM PARAMETERS message to comply with 128K 
minimum configuration unless the 3330 or 2305 devices are being used, then reply 
00, , RAM=01*. Reply no to the reguest for a SYS1.DUMP data set. Reply no to the 
change partitions message. Wait for the READY message and for the WAIT light to 
be turned on. Then enter a SET command specifying the date, as follows: 

a. Press the REQUEST key. 

b. Wait for the READ light to go on. 

c. Type SET DATE=yy . ddd , Q= ( , F ) to specify date. 

d. Signal EOB. 

e. Reply U to the SPECIFY JOB QUEUE PARAMETERS message and wait 
for the WAIT light to go on. 

17** Commands must be entered to start a SYSOUT writer, a reader, and 
an initiator. It is recommended that the direct SYSOUT writer be 
used. The commands are: 

MN JOBNAMES 
START DSO.P1,00E 
START RDR.S,00C 
START INIT. ALL 

If 00E and 00C are not the addresses of the writer and reader, 
enter the correct addresses. 

18** When the job is complete, a READER ENDED message will be printed, 
followed by a JOB ENDED message. The system will then enter the 
wait state. See the OS Operator* s Reference for a discussion of 
stopping the system for MFT. 
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List System Data 

19. To list the data describing the system, place the control deck 
shown below in the input device. 

Then enter a START RDR.S,00C command. 

//J0B2 JOB ACCT123, PROGRAMMER, MSGLEVEL^I 

//STEP1 EXEC PGM=IEHLIST 

//SYSPRINT DD SYSOUT=A 

//DD1 DD UNIT=2314,DISP=OLD,VOLUME=SER=DLIB01 

//DD2 DD UNIT=2314,DISP=OLD,VOLUME=SER=DLIB02 

//SYSIN DD * 

LISTCTLG 

LISTVTOC DUMP,VOL=2314=DLIB01 

LISTVTOC VOL=2314=DLIB02,DOMP 

LISTPDS DSNAME=(SYS1.PROCLIB X 

[, Optional PDSs on System Residence]) 

LISTPDS DSNAME=(SYS1.M0DGEN,SYS1.GENLIB,SYS1.SAMPLIB) 
/* 

If J0B2 is run immediately after J0B1 (in Step 12), eliminate the J0B2 
card. In the LIST deck, any of the partitioned data sets shown in Figure 
90 may be specified in the LISTPDS statement. 

Note; You must carry out the IPL procedure (the steps denoted with an 
**) if the preceding punch operation was skipped. 



Deleting Libraries 

To make additional direct-access storage available for the system generation 
process, SYS1.SAMPLIB can be deleted from DLIB01 before starting the system 
generation process. This may be accomplished by loading the operating system 
and using the control deck shown in the input device. 

//J0B2 JOB ACCT123, PROGRAMMER, MSGLEVEL=1 

//STEP2 EXEC PGM=IEHPROGM 

//SYSPRINT DD SYSOOT=A 

//DD1 DD ONIT =2311, DISP=OLD,VOLUME=SER=DLIB03 

//SYSIN DD * 

SCRATCH DSNAME=SYS 1. SAMPLIB, VOL=23J_1=DLIB03 , PURGE 
/* 
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3330 Package — Tape Distribution 

The procedure for processing the tape distribution of the 3330 starter operating 
system package is as follows: 

Initialize Disk 

1. Mount the disk pack onto which DLIB01 will be restored. 

2. Mount the tape distribution (DLIB01) of the starter package. This is one 
1600-BPI tape or two 800-BPI tapes. 

3. Load the IBCDASDI program from the tape by setting the load selector 
switches and pressing the console LOAD key. When the program is loaded, 
the wait state is entered and the hexadecimal value FFFF is displayed in 
the console lights. 

4. Place the following control deck in the input device to initialize the 
disk: 

JOB 

MSG TODEV=1403,TOADDR=00E 

DADEF TODEV=3330,TOADDR= "T5"0", VOLID = SCRATCH,FLAGTEST=NO 

VLD NEWVOLID= DLIB0 1 , OWNERID =DEPT38 

VTOCD STRTADR=50 , EXTENT= 10 

END 

In the DADEF statement, the FLAGTEST=NO parameter must be used when the 
disk is initialized for the first time only. 

5. Define the control statement input device by pressing the REQUEST key of 
the printer keyboard. The message DEFINE INPUT DEVICE will be printed. 
Enter the message INPUT=xxxx cuu, where xxxx is the device type, c is the 
channel address, and uu is the unit address. The device type can be 1442, 
2400, or 2540. 

6. When the disk initialization is complete, the message END OF JOB is printed 
on the message output device, and the program enters the wait state. 

Restore Tape to Disk 



7. Load the IBCDMPRS program from tape by setting the load selector switches 
and pressing the console LOAD key. When the program is loaded, the wait 
state is entered and the hexadecimal value FFFF is displayed in the console 
lights. 

8. Place the following control deck in the input device to restore the contents 
of the tape to the disk: 

JOB 

MSG TODEV= 1403, T OADDR ^OOE 

RESTORE FROMDEV=24 00 r FROMADDR= 180, TODEV=3330, X 

TOADDR= 1 50 , VOLID -DL IBO 1 
END 

9. Define the control statement input device by pressing the REQUEST key of 
the printer keyboard. The message DEFINE INPUT DEVICE will be printed. 
Enter the message INPUT=xxxx cuu, where xxxx is the device type, c is the 
channel address, and uu is the unit address. The device type can be 1442, 
2400, or 2540. 
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10. When the restoring is complete, the message END OF JOB is printed on the 
message output device, and the program enters the wait state. 

The DLIB01 tape should be removed and stored in the tape library for backup 
purposes. 

Restore Second Tape to Disk 



11. (Do this step if you have two 800-BPI tapes. If you have a 1600-BPI tape, 
proceed to step 12.) After pressing the LOAD key to skip over the IBCDASDI 
program repeat steps 7 through 10 to restore the contents of the tape to 
the disk. When this step is completed, there will be an operable disk 
pack with backup tape. 

12. lou can now carry out the IPL procedure (the steps denoted with an **) 
with the DLIB01 volume. 

Punch Utility and Sample Programs 



13. Completion of the preceding steps provides an operable disk pack with a 
backup tape. Punch the independent utility programs and any sample programs 
desired. Be sure the necessary volumes are mounted and make ready all 
devices to be used. 

14. The following control deck should be placed in the input device. 

//JOB1 JOB ACCT123, PROGRAMMER, MSGLEVEL=1 

// EXEC PGM=IEBPTPCH 

//SYSUT1 DD DSNAME=SYS1.SAMPLIB,DISP= (OLD, KEEP) 

//SYSUT2 DD UNIT= 25*l0-2 

//SYSPRINT DD SYSODT=A 

//SYSIN DD * 

PUNCH TYPORG=PO,MAXNAME=4 

MEMBER NAME=IBCDMPRS 

MEMBER NAME=IBCDASDI 

MEMBER NAME=IEAIPL00 
/* 

A MEMBER card should be added to the above control deck for the sample 
program desired for later use, and for SAMACTRT, provided the MAXNAME field 
in the PUNCH control card is adjusted to show the revised number of member 
cards in the deck. The member name card (first card) should be removed 
from each member deck punched. (Refer to the "Testing the New System" 
section of this publication for names of the sample programs.) 

15** Set the LOAD UNIT switches on the control panel to the channel, control 
unit, and device of the system-residence volume (DLIB01). Then press the 
LOAD key. 

16** Reply 00,»RAM=01» to the SPECIFY SYSTEM PARAMETERS message which makes 
access methods TGG019C0, IGG019CU, IGG019EK, IGG019FN, and IGG019FP 
resident. 

Reply no to the reguest for a SYS1.DUMP data set. Reply no to the change 

partitions message. Wait for the READY message and for the WAIT light 

to be turned on. Then enter a SET command specifying the date, as follows: 

a. Press the REQUEST key. 

b. Wait for the READ light to go on. 

c. Type SET DATE=yy .ddd,Q= (,F) to specify date. 

d. Signal EOB. 

e. Reply U to the SPECIFY JOB QUEUE PARAMETERS message and wait for the WAIT 
light to go on. 
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17** Commands must be entered to start a SYSOOT writer, a reader, and an 

initiator. It is recommended that the direct SYSOOT writer be used. The 
commands are: 

MN JOBNAMES 
START DSO.P1,COE 
START RDR.S,00C 
START INIT. ALL 

If 00E and 00C are not the addresses of the writer and reader, enter the 
correct addresses. 

18** When the job is complete, a READER ENDED message will be printed, followed 
by a JOB ENDED message. The system will then enter the wait state. See 
the OS Operator's Reference for a discussion of stopping the system for 
MFT. 



List System Data 



19. To list the data describing the system, place the control deck shown below 
in the input device. 

Then enter a START RDR.S,00C command. 

//JOB 2 JOB ACCT123,PROGRAMMER, MSGLEVEL=1 

//STEP1 EXEC PGM=IEHLIST 

//SYSPRINT DD SYSOUT=A 

//DD1 DD UNIT=3330,DISP=OLD,VOLUME=SER=DLIB0 1 

//SYSIN DD * 

LISTCTLG 

LISTVTOC DUMP,VOL=3330=DLIB01 

LISTPDS DSNAME=(SYS1.PROCLIB X 

[, Optional PDSs on System Residence]) 

LISTPDS DSNAME=(SYS1.M0DGEN,SYS1.GENLIB,SYS1.SAMPLIB) 
/* 

If JOB2 is run immediately after J0B1 (in Step 12), eliminate the J0B2 
card. In the LIST deck, any of the partitioned data sets shown in Figure 
90 may be specified in the LISTPDS statement. 

Note : You must carry out the IPL procedure (the steps denoted with an 
**) if the preceding punch operation was skipped. 



Deleting Libraries Using a 3330 

To make additional direct access storage available for the system generation 
process, SYS1.SAMPLIB can be deleted from DLIB01 before starting the system 
generation process. This may be accomplished by loading the operating systei 
and using the control deck shown in the input device. 

//JOB2 JOB ACCT1 23, PROGRAMMER, MSGLEVEL= 1 

//STEP2 EXEC PGM=IEHPROGM 

//SYSPRINT DD SYSOUT=A 

//DD1 DD ONIT= 3330, DISP=OLD,VOLUME=SER=DLIB01 

//SYSIN DD * 

SCRATCH DSNAME=SYS1.SAMPLIB,VOL=3330=DLIB01, PURGE 
/* 
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The Job Stream — Stage II 



This section discusses the non-TSO and TSO job streams that result from Stage 
I of the system generation program. Both parts contain a brief description 
of the job stream, a diagram illustrating the job stream and the data sets 
affected, and a sample listing of the job control language statements. 
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Non-TSO Generation 

If no error messages are printed during Stage I, the job stream is produced 
on the SYSPUNCH data set. The job stream contains one JOB statement followed 
by many EXEC statements (see Figure 26). Each EXEC statement is followed by 
its associated DD statements and other data required to execute the assembler, 
linkage editor, and utility programs during Stage II. 

The steps are numbered in Figure 26 for easy reference to the text. 

The format of the JOB statement is: 

//SYSGEN JOB 1,« SYSTEM GENERATION* 

Note: This JOB statement is produced if JOBSTMT=SUPPLIED is not specified 

in the GENERATE macro instruction. If SUPPLIED is specified, your JOB statement 

is produced. 

The format of the EXEC statement is: 

//SGXX EXEC PGM=program[ ,COND=condition][ ,PARM=value] 

where: 

SGXX 

is the step name. XX represents sequential identification numbers supplied 
by the system generation process. The step name is printed in the IEF236I 
allocation message while the step is being initiated. For example, the 
message 

IEF236I ALLOC. FOR SYSGEN SG7 

indicates that the seventh step is being executed. 

PGM 

indicates the name of the program being executed. The names are ASMBLR, 
IFCEREPO, IEWL, IEBCOPY, IEHIOSOP, IFCDIPOO, IEHPROGM, and IEHLIST. The 
programs are executed in the order shown in Figure 19, the assembler 
(ASMBLR) and the linkage editor (IEWL) are executed several times. The 
IEWL step © builds the new SYS 1 .NUCLEUS. Six IEHPROGM steps may be 
executed; the ones that are executed depend on specifications in the 
GENERATE macro instruction. 

COND 

enables all the job steps to test whether the previous step was successfully 
completed. If the previous step was unsuccessful, the remaining steps 
are bypassed and Stage II is terminated. 

PARM 

is supplied for job steps that require PARM information. 
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EBCOPY 




//SGXX EXEC 
//7sYSGEN JOB 



Legend 



GENERATING SYSTEM 



t J NEW SYSTEM 



Figure 26 (Part 1 of 2) . The Stage TI Non-TSO Job Stream 
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Figure 26 (Part 2 of 2) . The Stage II Non-TSO Job Stream 
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During the ASMBLR steps © , selected modules are assembled and stored in 
the utility data set defined by the OBJPDS DD statement in Stage I. 

IEBCOPY utility program step Q) copies SYS1.MACLIB and SYS1.TCAMMAC (if TCAM 
is specified) to the new system. This IEBCOPY step is produced only if the 
MACLIB macro instruction was specified in Stage I. IEHPROGM utility program 
step © renames the new MACLIB data set to SYS1. MACLIB. This step is produced 
only if the MACLIB macro instruction is specified and your own qualifier was 
coded in the INDEX parameter of the GENERATE macro instruction. 

The modules assembled during the ASMBLR steps © and other modules from 
SYS 1. component libraries are processed during the IEWL steps © (s) (Tu) to 
form load modules. These load modules are placed in the new SYS 1 .NUCLEUS, 
SYS1. SVCLIB, SYS1. LINKLIB, SYS1.ALGLIB, SYS1.C0BLIB, SYS1 .FORTLIB, 
SYS 1. TELCMLIB, and SYS1 . IMAGELIB. Only one IEWL step, step ©, is produced 
during a nucleus generation. 

If UTDISP=UNCATLG or DELETE is specified in the GENERATE macro instruction, 
two IEHPROGM ste Pf are executed. The first one, step © , uncatalogs or deletes 
the data sets defined by UT1SDS and UT2SDS parameters of the GENERATE macro 
instruction. The second one, step (ij) , uncatalogs or deletes the data sets 
defined by the UT3SDS and UTUSDS keyword parameters of the GENERATE macro 
instruction. If UTDISP=KEEP is specified in the GENERATE macro instruction, 
the IEHPROGM steps are not produced. 

During an I/O generation, if LOGREC=PRINT is specified in the GENERATE macro 
instruction, IFCEREPO (EREP) st ep © will print SYS1.LOGREC. IEHPROGM step 
© scratches SYS1.L0GREC and, if MCRi's specified, uncatalogs and scratches 
SYS1. ASRLIB. 

IEBCOPY ste 



£ © copies load modules to the new SYS1. SVCLIB, SYS1.PL1LIB, 
, SYS1.LINKLIB, SYS 1 . IMAGELIB, SYS 1 . FORTLIB, and SYS 1 . TELCMLIB. 



SYS1.C0BLIB, .__ ._. 

This step is not produced during a nucleus generation or a processor generation. 

IEBCOPY step (Tj) copies load modules to the new SYS1 .PARMLIB, SYS1.PL1LIB, 
SYS1. FORTLIB, SYS1.C0BLIB, SYS 1 . SORTLIB, SYS1.ALGLIB, SYS 1 . PROCLIB, SYS1.SVCLIB, 
and SYS1.LINKLIB. This step is produced only if GENTYPE=ALL or PROCESSOR and 
the appropriate processor macro instructions were specified during Stage I. 

IEBCOPY step @ copies user-written load modules to SYS1.SVCLIB and to 
SYS1.LINKLIB from the data sets specified in the SVCLIB and LINKLIB macro 
instructions. This step is produced only if the SVCLIB or LINKLIB macro 
instruction is used during Stage I. 



IEHIOSUP utility program @ builds the XCTLtables for type H SVCs in 
SYS1. SVCLIB. The IFCDIPOO utility program n|) initializes SYS1.L0GREC and 
allocates space for SYS1. ASRLIB. The IEHIOSUP and IFCDIPOO steps are produced 
for complete operating system and I/O device generations. 

IEHPROGM step (Jj) catalogs SYS1. ASRLIB and SYS1.L0GREC. This step is produced 
only if SER=MCH is specified in the SUPRVSOR macro instruction during Stage 
I. 

IEBUPDTE utility program @ generates a 40-byte record on SYS 1. ASRLIB. This 
step is produced only if MODEL=85 is specified in the CENPROCS macro instruction 
during Stage I. 

IEHPROGM step @ renames any of the following new system data sets if you 
defined them with qualifiers: ALGLIB, ASRLIB, COBLIB, FORTLIB, IMAGELIB, 
LINKLIB, LOGREC, NUCLEUS, PARMLIB, PL1LIB, PROCLIB, SORTLIB, SVCLIB, or 
TELCMLIB. This step is produced if a user-supplied qualifier was coded in 
the INDEX parameter of the GENERATE macro instruction. 
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IEHLIST utility program @ lists the catalog of the new system-residence 
volume and any other data specified with the DIRDATA parameter of the GENERATE 
macro instruction. This step is not produced during a nucleus generation. 

Figure 27 shows sample job control language statements for each type of step 
in the job stream. The values selected for the parameters result from the 
specifications in the system generation macro instructions. In Figure 27, 
the underlined macro instruction keywords are used to show where the values 
indicated by those keywords are placed. These keywords are from the GENERATE 
macro instruction unless otherwise indicated by a comment. Remarks (preceded 
by ...) do not appear in the statements. 



Assembler 

//SGXX EXEC PGM=ASMBLR,COND=(U,LT) 

//SYSLIB DD DSNAME=SYS1.M0DGEN,DISP=(SER,PASS) 

// DD DSNAME=SYS1.M0DGEN2,DISP=(SHR,PASS) 

// DD DSNAME=SYS1.MACLIB,DISP=SHR,V0LUME= (, RETAIN) 

//SYSUT1 DD DISP=OLD,VOLUME= (, RETAIN) , LABEL = (,UT_1SDS) ,DSNAME=UT1_SDS_ 

//SYSDT2 DD DISP=OLD, VOLUME= (, RETAIN) , LABEL= (,UT2SDS) , DSNAME=UT2SDS 

//SYSUT3 DD DISP=OLD # VOLUME= ( # RETAIN) ,DSNAME=UT1SDS 

//SYSPRINT DD SPACE= ( 1 2 1 , (50 0, 1 000) , RLSE) ,DCB= (RECFM=FB, X 

// LBECL=121,BLKSIZE=3509) , SYSOOT=A 

//SYSPUNCH DD DISP=OLD, V0LUME= (, RETAIN) , DSNAME=OBJPDS (member) 

//SYSIN DD * 

PRINT ON, NODATA 

IEHPROGM 

//SGXX EXEC PGM=IEHPROGM 

//LOGREC DD DISP=OLD, UNIT= RESNAME, VOLUME^ (, RETAIN, SER= RESVOL) 

//SYSPRINT DD SYSOUT^A, SPACE= (1 2 1 , (500, 1000) ,RLSE) , X 

// DCB=(RECFM=FB,LRECL=121,BLKSIZE=121) 

//SYSIN DD * 

IEBCOPY 

//SGXX EXEC iPGM=IEBCOPY,COND=(8,LT) 

//SYSUT3 DD DISP=OLD,VOLUME= (, RETAIN) ,DSNAME=0T3SDS 

//SYSUT4 DD DISP=OLD,VOL0ME= (, RETAIN) ,DSNAME=0T1SDS 

//SYSPRINT DD SPACE= ( 1 21 , (50 0, 1 000) , RLSE) ,DCB= (RECFM=FB, X 

// LRECL=121,BLKSIZE=121) ,SYSOUT=A 

//coraplib DD DISP=SHR,DSNAME=component library, VOLOME= (, RETAIN) 

//SVCLIB DD DISP=OLD,VOLUME= (.RETAIN, SER= RESVOL) ,UNIT= RESNAME. X 

// DSNAME=index. SVCLIB 

//LINKLIB DD DISP=OLD, VOLUHE= (, RETAIN, SER=LINKVOL) ,UNIT=LINKNAME, X 

// DSNAME=index. LINKLIB 

//SYSIN DD * 

IFCEREP0 

//SGXX EXEC PGM=IFCEREP0 

//STEPLIB DD DSNAME=SYS1. LINKLIB, ONIT=LNKNAME / DISP=SHR, X 

// VOLUHE= ( , RETAIN, SER= LNK VOL) 

//SERLOG DD DSNAME=SYS 1. LOGREC, UNIT= RES NAME, DISP=SHR, X 

// VOLUHE= (.RETAIN, SER- RESVOL ) 

//ERFPPT DD SYS0DT=A, SPACE= (121, (500,1000) , RLSE) , X 

// DCB=(RECFH=FB,LRECL=121,BLKSIZE=121) 

Figure 27 (Part 1 of 2) . Sample Steps in the Job Stream 
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Linkage Editor 

//SGXX EXEC PGM=IEWL,PARM=»NCAL,XREF, LIST, LET 1 ,COND= (8, LT) 

//SYS0T1 DD DISP=OLD,VOLUME=(, RETAIN) ,DSNAME= UT3SDS 

//SYSPRINT DD SPACE= ( 1 21 , (50 0, 1 000) , RLSE) , DCB= (RECFM=FB, X 

// LRECL=121,BLKSIZE=121) ,SYSO0T=A 

//SYSLMOD DD DISP=OLD, UNIT= RESNAME, VOLUME=SER= RESVOL, X 

// DSNAME=index.name(member) 

//complib DD DISP=SHR,DSNAME=component library, VOLDME= (, RETAIN) 

//SYSPUNCH DD DISP=OLD,VOLUME= (, RETAIN) , DCB= (RECFM=F,BLKSIZE=80) , X 

// DSNAME=OBJPDS 

//RESLIB DD DISP=SHR,VOLUME= (, RETAIN) ,DSNAME=PDS . . . RESMODS macro 

//SYS LIN DD * 

IEHIOSDP 

//SGXX EXEC PGM=IEHIOSUP,COND=(8,LT) 

//SYSUT1 DD DSNAME=inaex. SVCLIB,DISP= (OLD, KEEP) , X 

// UNIT= RESNAHE, VOLOME=SER= RESVOL 

//SYSPRINT DD SPACE= ( 121, (500,1000) , RLSE) ,DCB= (RECFM=FB, X 

// LRECL=121,BLKSIZE=121) SYSOOT=A 

IFCDIP00 

//SGXX EXEC PGM=IFCDIP00,COND=(8,LT) 

//SERERDS DD DSNAHE=index. LOGREC,ONIT= RESNAME, DISP= (NEW, KEEP) , X 

// VOLUME=(, RETAIN, SER=RESVOL) ,SPACE= (allocation) 

IEHLIST 

//SGXX EXEC PGM=IEHLIST 

//LINK DD DISP=OLD, VOLUME (, RETAIN, SER= LNKYOL ) ,ONIT= LNKNAME 

//SYSRES DD DISP=OLD.VOLOME= (. RETAIN. SER^RESVOL) ,ONIT= RESNAME 

//SYSPRINT DD SPACE= ( 1 21 , (500, 1 000) , RLSE) ,DCB= (RECFM=FB, X 

// LRECL=121,BLKSIZE=121) ,SYSODT=A 

//SYSIN DD * 

Figure 27 (Part 2 of 2) . Sample Steps in the Job Stream 
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TSO Generation 

If no error messages are printed during Stage I, the job stream is produced 
on the SYSPUNCH data set. The job stream contains one JOB statement followed 
by many EXEC statements (see Figure 28) . Each EXEC statement is followed by 
its associated DD statements and other data required to execute the assembler, 
linkage editor, and utility programs during Stage II. 

The steps are numbered in Figure 28 for easy reference to the text. 

The format of the JOB statement is: 

//SYSGEN JOB 1,' SYSTEM GENERATION* 

Note: This JOB statement is produced if JOBSTMT=SUPPLIED is not 
specified in the GENTSO macro instruction. If SUPPLIED is specified, 
your JOB statement is produced. 

The format of the EXEC statement is: 

//SGXX EXEC PGM=program[ ,COND=condition][ ,PARM= value] 

where: 

SGXX 

is the step name. XX represents sequential identification numbers supplied 
by the system generation process. The step name is printed in the IEF236I 
allocation message while the step is being initiated. For example, the 
message 

IEF236I ALLOC. FOR SYSGEN SG7 

indicates that the seventh step is being executed. 

PGM 

indicates the name of the program being executed. The names are ASMBLR, 
IFCEREPO, IEWL, IEBCOPY, IEHIOSOP, IFCDIPOO, IEHPROGM, and IEHLIST. The 
programs are executed in the order shown in Figure 28. The assembler 
(ASMBLR) and the linkage editor (IEWL) are executed several times. IEWL 
step <jj) builds the new SYS 1. NUCLEUS. Seven IEHPROGM steps may be 
executed; the ones executed depend on specifications in the GENTSO macro 
instruction. 

COND 

enables all the job steps to test whether the previous step was successfully 
completed. If the previous step was unsuccessful, the remaining steps 
are bypassed and Stage II is terminated. 

PARM 

is supplied for job steps that require PARM information. 
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Figure 28 (Part 1 of 2) . The Stage II TSO Job Stream 
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Figure 28 (Part 2 of 2) . The Stage II TSO Job Stream 
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During the ASMBLR steps (T) and (2), selected modules are assembled and stored 
in the utility data set defined by the OBJPDS DD statement in Stage I. 

The IEBCOPY utility program step @ copies modules to SYS1.HELP, SYS1.CMDLIB, 
SYS1.UADS, SYS1.LINKLIB, and SYS1. SVCLIB. IEHPROGM utility program step (5) 
renames SYS 1. HELP and SYS1.UADS. 

IEBCOPY step (?) copies SYS1. MACLIB, SYS 1 .TCAMMAC, and SYS1.TSOMAC to the new 
system. This IEBCOPY step is produced only if the MACLIB macro instruction 
was specified in Stage I. IEHPROGM step (&\ renames the new MACLIB data set 
to SYS 1. MACLIB. This step is produced only if the MACLIB macro instruction 
is specified and your own qualifier was coded in the INDEX parameter of the 
GENTSO macro instruction. 

The modules assembled during the ASMBLR steps (2) and other modules from SYS1 
component libraries are processed during IEWL steps (3) to form load modules. 
These load modules are placed in the new SYS1.CMDLIB, SYS1. SVCLIB, and 
SYS1.LINKLIB. 



The modules assembled during the ASMBLR step (7) and other modules from SYS1 

component libraries are processed during the IEWL steps (1J) uz) nU) to form 

load modules. These load modules are placed in the new s*YS 1. nucleus, 

SYS1. SVCLIB, SYS1.LINKLIB, SYS1.ALGLIB, SYS1.C0BLIB, SYS1 .FORTLIB, SYS 1 . SORTLIB, 

and SYS1.TELCMLIB. Only one IEWL step, step (Q) , is produced during a nucleus 

generation. 

If OTDISP=ONCATLG or DELETE is specified in the GENTSO macro instruction, two 
IEHPROGM steps are executed. The first one, step (i) , uncatalogs or deletes 
the data sets defined by 0T1SDS and UT2SDS parameters of the GENTSO macro 
instruction. The second one, step (fr) , uncatalogs or deletes the data sets 
defined by the DT3SDS and 0T4SDS keyword parameters of the GENTSO macro 
instruction. If UTDISP=KEEP is specified in the GENTSO macro instruction, 
these IEHPROGM steps are not produced. 

During an I/O generation, if LOGREC=PRINT is specified in the GENTSO macro 
instruction, IFCEREPO (EREP) step (3) will print SYS1.L0GREC. IEHPROGM step 
(TB) scratches SYS1.L0GREC and, if MCH is specified, uncatalogs and scratches 
SYS1.ASRLIB. 

IEBCOPY step @ copies load modules to the new SYS1.SVCLIB, SYS1.PL1LIB, 
SYS1.C0BLIB, SYS1.LINKLIB, SYS 1 .FORTLIB, and SYS 1 . TELCMLIB. This IEBCOPY step 
is not produced during a nucleus generation or a processor generation. 

IEBCOPY step @ copies load modules to the new SYS1 .PARMLI3, SYS1.PL1LIB, 
SYS1. FORTLIB, SYS1.COBLIB, SYS 1 .SORTLIB, SYS1.ALGLIB, SYS 1. PROCLIB, SYS1.SVCLIB, 
and SYS1.LINKLIB. This step is produced only if GENTYPE=ALL or PROCESSOR and 
the appropriate processor macro instructions were specified during Stage I. 

IEBCOPY step (lb) copies user-written load modules to SYS1.SVCLIB and to 
SYS1.LINKLIB from the data sets specified in the SVCLIB and LINKLIB macro 
instructions. This step is produced only if the SVCLIB or LINKLIB macro 
instruction is used during Stage I. 

IEHIOSDP utility program @ builds the XCTL tables for type 4 SVCs in 
SYS1. SVCLIB. When running IEHIOSUP against a TSO system, the EXEC card must 
include PARM=TSO. The IFCDIPOO utility program @ initializes SYS1.LOGREC 
and allocates space for complete operating system and I/O device IFCDIPOO steps 
are produced for complete operating system and I/O device generations. 



IEHPROGM step (2_§) catalogs SYS1.ASRLIB and SYS1.L0GREC. This step is produced 
only if SER=MCH is specified in the SOPRVSOR macro instruction during Stage 
I. 

IEBUPDTE utility program (2j) generates a 40-byte record on SYS1.ASRLIB. This 
step is produced only if MODEL=85 is specified in the CENPROCS macro instruction 
during Stage I. 
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IEHPROGM step (22) renames any of the following new system data sets that were 
defined with user-supplied qualifiers: ALGLIB, ASRLIB, COBLIB, FORTLIB, 
LINKLIB, LOGREC, NUCLEUS, PARMLIB, PL1LIB, PROCLIB, SORTLIB, SVCLIB, or 
TELCMLIB. This step is produced if you coded your own qualifier in the INDEX 
parameter of the GENTSO macro instruction. 



IEHLIST utility program (23) lists the catalog of the new system-residence 
volume and any other data specified with the DIRDATA parameter of the GENTSO 
macro instruction. This step is not produced during a nucleus generation. 

Figure 29 shows sample job control language statements for each type of step 
in the job stream. The values selected for the parameters result from the 
specifications in the system generation macro instructions. In Figure 29, 
the underlined macro instruction keywords are used to show where the values 
indicated by those keywords are placed. These keywords are from the GENTSO 
macro instruction unless otherwise indicated by a comment. Remarks (preceded 
by ...) do not appear in the statements. 



Assembler 

//SGXX EXEC PGH=ASMBLR,C0ND=(4,LT) 

//SYSLIB DD DSNAME=SYS1.M0DGEN,DISP= (SHR,PASS) 

// DD DSNAME=SYS1.M0DGEN2,DISP=(SHR,PASS) 

// DD DSNAME=SYS1.MACLIB,DISP=SHR,V0LUME= (, RETAIN) 

//SYSUT1 DD DISP=OLD,VOLUME= (, RETAIN) ,LABEL= (,UTJ_SDS) ,DSNAME=UT1SDS 

//SYSUT2 DD DISP=OLD,VOLUME= (, RETAIN) ,LABEL= (,UT2SDS) , DSNAHE=UT2_SDS 

//SYSUT3 DD DISP=OLD,VOLUME= (, RETAIN) ,DSNAME=UT3SDS_ 

//SYSPRINT DD SPACE= (1 21 , (500, 1 000) , RISE) ,DCB= (RECFM=FB, X 

// LRECL=121,BLKSIZE=3509) ,SYS0UT=A 

//SYSPUNCH DD DISP=0LD, VOLUME= (, RETAIN) , DSNAME=0BJPDS (member) 

//SYSIN DD * 

PRINT QN,NODATA 

Assembler 

//SGXX EXEC PGM=ASHBLR,COND=(4,LT) 

//SYSLIB DD DSNAME=SYS1.TSOGEN,DISP=(SHR,PASS) 

// DD DSNAME=SYS1.MODGEN2,DISP=SHR,VOLUME=(, RETAIN) 

// DD DSNAHE=SYS1.M0DGEN,DISP=SHR,V0LUHE=(, RETAIN) 

// DD DSNAME=SYS1.TSOMAC,DISP=SHR,VOLUME=(, RETAIN) 

// DD DSNAME=SYS1.MACLIB,DISP=SHR,VOLUME=(, RETAIN) 

//SYSUT1 DD DISP-OLD, VOLUME- (, RETAIN) ,LABEL= (, UT1SDS ) , DSNAME= UT 1 SDS 

//SYSUT2 DD DISP=OLD,VOLUME= (, RETAIN) , LABEL= (, UT2SDS) ,DSNAME=UT2SDS 

//SYSUT3 DD DISP=OLD,VOLUME= (, RETAIN) ,DSNAME=UT3SDS 

//SYSPRINT DD SPACE= ( 1 2 1 , (50 0, 1 000) , RLSE) ,iDCB= (RECFM=FB, X 

// LRECL=121,BLKSIZE=35Q9) ,SYSOUT=A 

//SYSPUNCH DD DISP=OLD, VOLUME= (, RETAIN) , DSNAME=OBJPDS (member) 

//SYSIN DD * 

PRINT ON,NODATA 

IEHPROGM 

//SGXX EXEC jPGM=IEHPROGM,COND=(8,LT) 

//LOGREC DD PIS P=OLD, UNIT= RESNAHE, VOLUME= (, RETAIN, SER= RESVOL ) 

//SYSPRINT DD SYSOUT=A, SPACE= ( 1 2 1 , (500 , 1000) ,RLSE) , X 

// DCB= (RECFM=FB,LRECL=121 f BLKSIZE=121) 

//SYSIN DD * 

Figure 29 (Part 1 of 2) . Sample Steps in the Job Stream 
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IEBCOPY 

//SGXX EXEC PGM=IEBCOPY,COND=(8,LT) 

//SYSOT3 DD DISP=OLD, VOL UME= (, RETAIN) , DSNAME=UT3SDS 

//SYSOT4 DD DISP=OLD, VOLUME= (, RETAIN) ,DSNAME=UTJ*SDS 

//SYSPRINT DD SPACE= (1 21 , (500, 1 000) , RLSE) ,DCB= (RECFM=FB, X 

// LRECL=121,BLKSIZE=121) ,SYSOOT=A 

//complib DD DISP=SHR,DSNAME=*component library, VOLUME- (, RETAIN) 

//SVCLIB DD DISP=OLD,VOLUME= (, RETAIN, SER= RESVOL ) ,UNIT= RESNAMB, X 

// DSNAME=index. SVCLIB 

//LINKLIB DD DISP=OLD, VOLDME= (, RETAIN, SER=L_INKVOL) ,UNIT=LINKNAME, X 

// DSNAHE=inaex. LINKLIB 

//SYS IN DD * 

IFCEREPO 

//SGXX EXEC jPGM=IFCEREP0,COND=(8,LT) 

//STEPLIB DD DSNAME-SYS1. LINKLIB, UNIT= LNKNAME, DISP^SHR, X 

// VOLUME- ( , RETAIN, SER= LNK VOL ) 

//SERLOG DD DSNAME=SYS 1. LOGREC,UNIT= RESNAME, DISP=SHR, X 

// VOLUME=(, RETAIN, SER=RESVOL) 

//ERFPPT DD SYSODT=A,SPACE= (121, (500,1000) , RLSE) , X 

// DCB=(RECFM=FB,LRECL=121,BLKSIZE=121) 

Linkage Editor 

//SGXX EXEC PGM-IEWL,PARM=»NCAL,XREF,LIST,LET»,COND=(8,LT) 

//SYSOT1 DD DISP=*OLD,VOLUME= (, RETAIN) ,DSNAME=tJT3SDS 

//SYSPRINT DD SPACE= ( 1 21 , (500, 1000) , RLSE) ,DCB= (RECFM=FB, X 

// LRECL=121,BLKSIZE=121) ,SYSOUT=A 

//SYSLMOD DD DISP=OLD,UNIT =RESNAME, VOLUME=SER= RESVOL. X 

// DSNAME=index. name (member) 

//complib DD DISP=SHR,DSNAME=component library, VOLUME^ (, RETAIN) 

//SYSPUNCH DD DISP=OLD,VOLUME= (, RETAIN) # DCB= (RECFM=F,BLKSIZE=80) , X 

// DSNAME=OBJPDS 

//RESLIB DD DISP=SHR,VOLUME= (, RETAIN) ,DSNAME=PDS . . . RESMODS macro 

//SYSLIN DD * 

IEHIOSUP 

//SGXX EXEC PGM=IEHIOSUP,PARM=TSO 

//SYSDT1 DD DSNAME=index. SVCLIB, DISP= (OLD, KEEP) , X 

// UNIT= RESNAME, VOLUME=SER= RE5VOL 

//SYSPRINT DD SPACE= ( 121, (500, 1000) , RLSE) ,DCB= (RECFM=FB, X 

// LRECL=121,BLKSIZE=121) ,SYSOUT=A 

IFCDIP00 

//SGXX EXEC PGM*IFCDIP00,COND=(8,LT) 

//SERERDS DD DSNAME=index.LOGREC.UNIT= RESNAME. DISP= (NEW, KEEP) , X 

// VOLUME= (, RETAIN, SER=RESVOL) ,SPACE= (allocation) 

IEHLIST 

//SGXX EXEC |PGM=IEHLIST,COND=(8,LT) 

//LINK DD DISP=OLD. VOLUMES RETAIN. SER= LNKVOL ) ,UNIT= LNKNAME 

//SYSRES DD DISP-OLD.VOLUME= ( # RETAIN.SER- RESVOL) .ONIT^ RESNAME 

//SYSPRINT DD SPACE=( 121, (50 0,1000) , RLSE) JDCB=(RECFM=FB, X 

// LRECL=121,BLKSIZE=121) ,SYSOUT=A 

//SYSIN DD * 

Figure 29 (Part 2 of 2) . Sample Steps in the Job Stream 
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Restart Procedures 



This section contains detailed inf or nation about restarting the system 
generation program and describes recovery procedures. The Stage I text 
discusses the most common causes of error, restart procedures, and an example 
of an input deck for restarting Stage I. 

The Stage II text discusses the most common causes of error, restart techniques, 
guidelines for restarting a non-TSO Stage II, guidelines for restarting a TSO 
Stage II, and reallocating data sets. Examples of the input decks are included. 
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The system generation process may come to an unsatisfactory completion due 
to errors during Stage I or Stage II. The procedures to restart Stage I and 
Stage II are described below. 



Restarting Stage I 



The most common causes of error during Stage I are: 

• Faulty allocation of the utility data sets for system generation. For 
example, if there is not enough space on the volume for the data set, an 
error occurs. 

• Keypunching errors in the input deck. 

• Contradictory or invalid specifications in the system generation macro 
instructions. 

Faulty allocation of the utility data sets usually causes an abnormal-end-of- 
task (ABEND) termination. Keypunching errors are indicated by system generation 
error messages or assembler error indications. Invalid specifications are 
indicated with the system generation error messages (see Appendix D) printed 
in the SYSPF.INT data set. If any system generation errors are found during 
Stage I, the job stream is not produced. 

Stage I consists of only one job step (execution of the assembler) and it can 
be restarted only from the beginning. To restart Stage I, follow these 
procedures: 

1. Correct the input deck for system generation. 

2. Scratch and uncatalog the utility data sets (specified by the OBJPDS, 
SYSUT1, SYSUT2, and SYSUT3 DD statements in the input deck). 

The utility data sets can be scratched and uncataloged if you insert the 
statements shown in Figure 30 in the input deck for system generation. These 
statements must precede the EXEC PGM=ASMBLR statement of the input deck, as 
shown in Figure 31. 

//SCRATCH EXEC PGM=IEFBR1 4 ! -RESTART DECK- 

//OBJPDS DD DSNAME=SYS1.name,DISP= (OLD, DELETE) 

//SYSUT1 DD DSNAME=SYS 1. name, DISP= (OLD, DELETE) 

//SYSUT2 DD DSNAME=SYS L name, DISP= (OLD, DELETE) 

//SYSDT3 DD DSNAME=SYS 1 . name, DISP= (OLD, DELETE) 



Figure 30. Control Statements to Scratch and Uncatalog the Utility Data Sets 

In the preceding statements, the values given to the DSNAME parameters must 
be the same as the values given to DSNAME in the corresponding DD statements 
in the input deck for Stage I. These statements represent a BR14 execution 
of the IEFBR14 utility program. The utility data sets are scratched and 
uncataloged through the job control language of the IEFBR14 program. 

Figure 31 shows an input deck for restarting Stage I. It is assumed that all 
errors in the input deck have been corrected. The four utility data sets are 
named SYS1. OBJECT, SYS LONE, SYS 1. TWO, and SYS1.THREE. SYS LONE resides on 
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an unlabeled 9-track magnetic tape volume whose serial number is 000167. 
SYS1. OBJECT, SYS1.TWO, and SYS1. THREE reside on 2311 volumes whose serial 
numbers are SYSTEM, GENVOL, and MODVOL, respectively. The job stream is to 
be punched by the device designated by the SYSCP unit name. 



//SYSGEN 

//SCRATCH 

//OBJPDS 

//SYSUT1 

//SYSUT2 

//SYSUT3 

//STEP 1 

//SYSLIB 

//OBJPDS 

// 

//SYSUT1 

// 

//SYSUT2 

// 

//SYSUT3 

// 

//DUMMY 
//SYSPONCH 
//SYSPRINT 
//SYSIN 



JOB MSGLEVEL=1 -SYSTEM GENERATION- 
EXEC PGM=IEFBR14 -RESTART DECK- 
DD DSNAME=SYS1. OBJECT, DISP= (OLD, DELETE) 
DSNAME=SYS1 ,ONE,DISP= (OLD, DELETE) 
DSNAME=S YS1. TWO, DISP= (OLD, DELETE) 
DSNAME=S YS1. THREE, DISP= (OLD, DELETE) 
EXEC PGM=ASMBLR -STAGE I INPUT DECK- 
DD DSNAME=SYS1.GENLIB,DISP=0LD 

DSNAME=SYS1. OBJECT, VOLUME=(, RETAIN, SER=SYSTEM) , 
DISP= (,CATLG) ,UNIT=2311,SPACE=(TRK, (40,20,8)) 
DSNAME=SYS1. ONE, VOLUME= (RETAIN, SER=000 167) , 
DISP=(,CATLG) ,UNIT=2400,LABEL=(,NL) 
DSNAME=SYS1. TWO, VOLUME=(, RETAIN, SER=GENVOL) , 
DISP=(,CATLG) ,UNIT=231 1,SPACE=(TRK, (240,20) ) 
DSNAME=SYS1. THREE, VOL UME=(, RETAIN, SER=MODVOL) , 
DISP= (,CATLG) ,UNIT=23 1 1 ,SPACE= (TRK, (300,20) ) 
DD VOLUME= (, RETAIN, REF=*. SYSUT3) ,SPACE= (TRK, (80)) 
DD UNIT=SYSCP 
DD SYSOUT=A 
DD * 



DD 
DD 
DD 



DD 



DD 



DD 



DD 



/* 
// 



System generation macro instructions 



END 



Figure 31. Restarting Stage I 



Restarting Stage II 

The most common causes of error during Stage II are: 

• Machine interruptions and noncontinuous machine time. 

• Faulty space allocation of the system data sets during the preparation 
for system generation, especially the primary allocation and the directory 
size. 

• Errors in the input deck that cannot be detected during Stage I. For 
example, if SYS 1. NUCLEUS was allocated space on volume 111111 during the 
preparation of system generation, and if RESVOL=A1111 1 is specified in 
the GENERATE macro instruction, an error occurs. 

• The job stream is too large for the generating SYS1.SYSJOBQE. 

• Procedural errors, such as volume mounting problems. 

Stage II consists of the execution of the job stream produced during Stage 
I. This job stream is one job that has several job steps. Restarting can 
be accomplished by starting at the beginning of any step in the job stream, 
providing all previous steps have been properly executed. Before restarting, 



80 



OS System Generation 



some other operations may be required depending upon the reason for restarting 
and the number of steps already executed. The following topics describe the 
job stream, discuss restart techniques, give guidelines for restarting Stage II, 
describe the reallocation of data sets, and give guidelines for changing the 
size of SYS1.SYSJ0BQE. 



RESTART TECHNIQUES 

Stage II can be restarted at the beginning of any job step. If any statements 
in the job stream are to be changed, the job stream must be in cards. If no 
statements are to be changed, the IEBEDIT utility program can be used to restart 
a job stream tape. Certain operations may have to be performed before 
restarting Stage II. (These operations are discussed in the "Guidelines for 
Restarting Stage II" section.) This section discusses the techniques used 
for restarting the job stream after any other necessary operations have been 
performed. The following topics describe restarting from cards, punching the 
job stream, and restarting from tape. 



Restarting From Cards 

If the job stream is on cards, a job step can be restarted by placement of 
a JOB card ahead of the step's EXEC card. A START RDR command must then be 
issued for the card reader. 



Punching the Job Stream 

If the unit (SYSPUNCH) specified for the job stream during Stage I was not 

a card punch, the IEBPTPCH utility program can be used to punch the job stream. 

Figure 32 shows the statements required for IEBPTPCH. 

//PUNCH JOB -PUNCH JOB STREAM- 

// EXEC PGM=IEBPTPCH 

//SYSUT1 DD UNIT=xxx,LABEL=(,NL) ,VOLUME=SER=serial,DISP=OLD 

//SYSUT2 DD (Parameters designating a card punch) 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD * 

PUNCH TYP0RG=PS,MAXFLDS=1 

RECORD FIELD=(80) 

/* 

Figure 32. Control Statements for IEBPTPCH 

• The value of the UNIT parameter of the SYSUT1 DD statement is the specific 
unit address of the magnetic tape drive on which the job stream tape 
resides. Unless the job stream tape had been demounted, the value of this 
UNIT parameter is the same as the value of the UNIT parameter of the 
SYSPUNCH DD statement in the input deck for Stage I. 

• The value of the VOLUME parameter of the SYSUT1 DD statement is either 
any external serial number you have assigned to the job stream tape reel 
or any arbitrary name chosen by the programmer. The system will issue 

a MOUNT command for the specified volume on the magnetic tape drive 
indicated with the UNIT parameter. (The system has no way of checking 
that the correct volume has been mounted because the job stream tape is 
unlabeled.) 
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• Sequence numbers can be specified for the punched cards using the CDSEQ 
and CDINCR parameters in the PUNCH utility statement. 

The assembly listing produced (SYSPRINT) at the end of Stage I contains a 
series of PUNCH statements. The operands of these PUNCH statements are the 
cards of the job stream. If a separate listing of the job stream is desired, 
the IEBPTPCH utility program can be used to print the job stream. 

Figure 33 shows a series of statements that can be used to punch the job stream 
on any 2540 card read punch. The SYSPUNCH DD statement in the Stage I input 
deck was: //SYSPUNCH DD UNIT=182,LABEL= (,NL) 

//PUNCH JOB -PUNCH JOB STREAM- 

// EXEC PGM=IEBPTPCH 

//SYSUT1 DD UNIT=182,LABEL=(,NL) , VOLUME=SER=EXLABL, DISP=0LD 

//SYSUT2 DD UNIT=2540-2 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD * 

PUNCH TYPORG=PS,MAXFLDS=1 

RECORD PIELD=(80) 

/* 

Figure 33. Punching the Job Stream 

Restarting From Tape 

The IEBEDIT utility program can be used to restart Stage II when the job stream 
is on tape. IEBEDIT should be used to restart from any job step after the 
first. To restart from the first step, issue a START RDR command for the tape 
drive that contains the job stream. 

IEBEDIT can be used to create a new job stream. The new job stream contains 
one of the following arrangements: 

• The job step you specify and all the steps that follow it, or 

• Only those job steps you specify, or 

• All job steps except those you specify. 

//RESTART JOB -RESTART STAGE II- 

// EXEC PGH=IEBEDIT 

//SYSPRINT DD SYSOUT=A 

//SYSUT1 DD UNIT=XXX,LABEL=(,NL) ,VOLUME=SER=serial,DISP=OLD 

//SYSUT2 DD UNIT=XXX,LABEL=(,NL) 

//SYSIN DD * 

EDIT START=SYSGEN,STEPNAME=SGXX[ , NOPRINT] 
or EDIT START=SYSGEN,TYPE=INCLUDE, X 

STEPNAME= (SGXX[ ,SGXX ]...)[, NOPRINT ] 
or EDIT START=SYSGEN,TYPE=EXCLUDE, X 

STEPNAME= (SGXX[ , SGXX ]...)[ , NOPRINT ] 
/* 

Figure 34. Control Statements for IEBEDIT 

• The value of the UNIT parameter of the SYSUT1 DD statement is the specific 
unit address of the magnetic tape drive on which the job stream tape 
resides. Unless the job stream tape had been demounted, the value of this 
UNIT parameter is the same as the value of the UNIT parameter of the 
SYSPUNCH DD statement in the input deck for Stage I. 
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• The value of the VOLUME parameter of the SYSUT1 DD statement is either 
any external serial number assigned to the job stream tape reel or any 
arbitrary name chosen by the programmer. The system will issue a MOUNT 
command for the specified volume on the magnetic tape drive indicated with 
the UNIT parameter. (The system has no way of checking that the correct 
volume has been mounted because the job stream tape is unlabeled.) 

• The value of the UNIT parameter of the SYSUT2 DD statement is the specific 
unit address of a magnetic tape drive. 

• Only one EDIT statement must be used. 

• If the TYPE parameter is omitted, STEPNAME specifies the first job step 
to be placed in the new job stream. All the steps that follow the job 
step specified are also placed in the new job stream. 

• If TYPE=INCLUDE or TYPE=EXCLUDE is specified, STEPNAME specifies the job 
steps to be included or excluded, respectively, from the new job stream. 
Individual job steps and sequences of job steps can be specified for 
inclusion or exclusion. For example: 

STEPNAME= (SG20,SG32-SG37,SG50) 

indicates that steps SG20, SG32 through SG37, and SG50 are to be included 
or excluded from the operation. 

• NOPEINT must be included if a listing of the new job stream is not desired. 
After the new job stream is created, a START RDR command must be issued 
for the magnetic tape drive designated by the SYSUT2 DD statement. 

Refer to OS Utilities, for a more detailed description of IEBEDIT. 

Figure 35 shows an IEBEDIT input deck for restarting Stage II. The job stream 
resides on unit 182. The new job stream will reside on unit 282. All job 
steps after and including SG7 are to be restarted. A listing of the new job 
stream is not desired. The START RDR command to start the new job stream is 
included with the IEBEDIT deck. The appropriate operations described in 
"Guidelines for Restarting Stage II" must have been performed. 

//RESTART JOB -RESTART STAGE II- 

// EXEC PGM=IEBEDIT 

//SYSPRtNT DD SYSOUT=A 

//SYSUT1 DD UNIT=182,LABEL=(,NL) , VOLUME=SER=J0BSTM,DISP=OLD 

//SYSUT2 DD UNIT=282,LABEL=(,NL) 

//SYSIN DD * 

EDIT START=SYSGEN, STEPNAME=SG7 , NOPRINT 

/* 

// START RDR, 282 

Figure 35. Input deck for IEBEDIT 



GUIDELINES FOR RESTARTING STAGE II (NON-TSO GENERATION) 

The following sections give guidelines for restarting during Stage II of a 
non-TSO generation. Restarting may require the scratching and reallocation 
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of data sets. When this is necessary, reference is made to the section 
"Reallocating Data Sets" for the procedure to be followed. After these 
operations have been performed, the actual restarting of Stage II can be 
accomplished by one of the methods described in "Restart Techniques." 

The numbered steps in this section refer to steps in Figure 26. 

Note: If you have specified a qualifier in the INDEX parameter of the GENERATE 
macro instruction and errors have occurred before the two IEHPROGM rename steps 
J) and (fB) , you should check to be sure that these rename steps have not been 
executed. If a library has been renamed with the qualifier SYS1 and it is 
necessary to restart a step that refers to that library, the IEHPROGM utility 
program can be used to rename the library with the qualifier you supplied. 

Restarting During Assemblies 

To restart at the beginning of any assembly, place the JOB card in front of 
the EXEC card of that assembly or use the IEBEDIT program. If more than one 
ASMBLR step has been executed, and if it is desired to restart at the beginning 
of Stage II (SG1 step) , the data set defined by the OBJPDS DD statement must 
be reallocated (see "Reallocating Data Sets") . 

All assemblies must be satisfactorily executed before the link-edit (IEWL) 
steps can be executed. 

Restarting Any IEHPROGM Step 

To restart, place the JOB card in front of the EXEC card of the step, or use 
the IEBEDIT program if the job stream is on tape. 

The ASMBLR, IEWL, IEBCOPY, IEHIOSUP, and IFCDIPOO steps must be executed without 
error before the IEHPROGM step Qj) i the rename IEHPROGM step, is executed. 

Restarting Link«*Edit Steps 



IEWL step (?) builds the new SYS1 .NUCLEUS. Subsequent IEWL steps, ® 
10 produce load modules for the new SYS1.SVCLIB, SYS 1. IMAGELIB, SYS1. 



and 
LINKLIB, 

and, if specified for the new system, SYS1.ALGLIB, SYS1.C0BLIB, SYS1.FORTLIB, 
SYS1.S0RTLIB, and SYS1 .TELCMLIB. 



If IEWL step (7) was executed, SYS 1, NUCLEUS must be reallocated before the 
step is restarted (see "Reallocating Data Sets") . 

To restart at the beginning of IEWL step (&) , any of the following libraries 
that contain system data must be reallocatea: SYS1.SVCLIB, SYS 1. IMAGELIB, 
SYS1. LINKLIB, SYS1.ALGLIB, SYS1.COBLIB, SYS1 .FORTLIB, SYS1 . SORTLIB, and 
SYS 1. TELCMLIB. If more than one IEWL step was executed, and if you want to 
restart with IEWL step (?) , SYS1. NUCLEUS must also be reallocated. 

If reallocation is not performed, the space already used in the new system 
libraries is not available, and therefore there may not be enough space 
available for these data sets. This is particularly important for those system 
data sets that cannot have a secondary allocation. If more than sufficient 
space was allocated to a data set during the preparation for system generation, 
the IEWL step that failed can be restarted without reallocation. 
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It is recommended that the reallocations indicatedabove be performed when 
you restart from the beginning of the IEWL steps (j) or ® . To restart from 
the beginning of Stage II, the data sets defined by the OBJPDS, SYSUT1, and 
SYSUT2 DD statements must also be reallocated. 

During an I/O generation, no reallocation is needed to restart a link-edit 
step unless a step failed because there was not enough space in a system data 
set. If there was not enough space, move the contents of the old library to 
the new library. Copy the data set to a scratch volume using the IEBCOPY 
utility program. Use IEHPROGM to scratch and uncatalog the space for the data 
set on its original volume. Allocate and catalog the required space for the 
data set on its original volume and use IEBCOPY to copy the data set from the 
scratch volume to its original volume. Then restart Stage II at the beginning 
of the link-edit step that failed. 



Restarting First IEBCOPY Step 

This IEBCOPY step Q) copies SYS1.MACLIB to the new system. To restart at 
the beginning of this step, the new SYS1.MACLIB must be reallocated (see 
"Reallocating Data Sets") . 



Restarting All Other IEBCOPY Steps 

IEBCOPY step (?) copies members to the new SYS1.SVCLIB, SYS1.COBLIB, 
SYS1.IHAGELIB, SYS1.PL1LIB, SYS1 . LINKLIB, SYS1 .PORTLIB, and SYS1 . TELCHLIB. 
No reallocation is needed to restart this step unless the step failed because 
there was not enough space in a system data set. Only the system data set 
that did not have enough space must be reallocated (see "Reallocating Data 
Sets") , because any member that existed in the new system data set will not 
be moved into it again when the step is restarted. 

If the data set that did not have enough space was SYS1.SVCLIB, SYS1.IMAGELIB, 
SYS 1. LINKLIB, SYS1 .FORTLIB, or SYS1 .TELCMLIB, one of the two following 
procedures must be performed: 

• Follow the procedures for restarting with IEWL step (5) as described in 
"Restarting Link Edit Steps" in the "Guidelines for Restarting Stage II 
(Non-TSO Generation) " section, or 

• Copy the data set to a scratch volume using the IEBCOPY utility program. 
Scratch and uncatalog the space for the data set on its original volume 
with IEHPROGM. Allocate and catalog the required space for the data set 
on its original volume. Use IEBCOPY to copy the data set from the scratch 
volume to its original volume. Restart Stage II at the beginning of IEBCOPY 

ste P ®- 

IEBCOPY step (jj) copies members to SYS1.SVCLIB, SYS 1 .FORTLIB, SYS1.C0BLIB, 
SYS1.ALGLIB, SYS1.PL1LIB, SYS1 .LINKLIB, SYS1.PROCLIB, SJS1 . SORTLIB, and 
SYS1.PARMLIB. The procedures to restart IEBCOPY step (?) also apply to this 
step. 



IEBCOPY step QJ) copies your members to thenew SYS1.SVCLIB or SYS1. LINKLIB. 
The procedures to restart IEBCOPY step (?) also apply to this step. 
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Restarting IEHIOSUP, IFCDIPOO, and IEHLIST 



The system data sets do not have to be reallocated when IEHIOSUP step (ijj) 

and IEHLIST step (T^) are restarted. Before restarting IFCDIPOO step (T5) , 

the DISP parameter of the DD statement for SYS1.LOGREC or SYS1.ASRLIB must 

be changed to DISP= (OLD, KEEP) , or SYS1.L0GREC and SYS1.ASRLIB must be scratched. 

The ASMBLR, IEWL, and IEBCOPY steps must be executed without error before 
IEHIOSUP step (Ji is executed. 



GUIDELINES FOR RESTARTING STAGE II (TSO GENERATION) 

The following sections give guidelines for restarting during Stage II of a 
TSO generation. Restarting may require the scratching and reallocation of 
data sets. When this is necessary, reference is made to the section 
"Reallocating Data Sets" for the procedure to be followed. After these 
operations have been performed, the actual restarting of Stage II can be 
accomplished by one of the methods described in "Restart Techniques." The 
numbered steps in this section refer to steps in Figure 28. 

Note; If you have specified a qualifier in the INDEX parameter of the GENTSO 
macro instruction and errors have occurred before the two IEHPROGH rename steps 
(IT) and (f^) , you should check to be sure that these rename steps have not been 
executed. If a library has been renamed with the qualifier SYS1 and it is 
necessary to restart a step that refers to that library, the IEHPROGH utility 
program can be used to rename the library with the qualifier you supplied. 



Restarting During Assemblies 

To restart at the beginning of any assembly, place the JOB card in front of 
the EXEC card of that assembly or use the IEBEDIT program. If more than one 
ASMBLR step has been executed, and if you want to restart at the beginning 
of Stage II (SG1 step) , the data set defined by the OBJPDS DD statement must 
be reallocated (see "Reallocating Data Sets") . 

All assemblies must be satisfactorily executed before the link-edit (IEWL) 
steps can be executed. 



Restarting Any IEHPROGM Step 



To restart, place the JOB card in front of the EXEC card of the step, or use 
the IEBEDIT program if the job stream is on tape. 

The ASMBLR, IEWL, IEBCOPY, IEHIOSUP, and IFCDIPOO steps must be executed without 
error before IEHPROGM step (22) (the rename IEHPROGM step) is executed. 



Restarting Link-Edit Steps 

IEWL steps 3 produce load modules for the new SYS1.SVCLIB, SYS 1.LINKLIB, 
and SYS1.CMDLIB. IEWL step (Jj) builds the new SYS1. NUCLEUS. Subsequent IEWL 
steps <Q and (J3J produce load modules for the new SYS1.SVCLIB, SYS1 .LINKLIB, 
and, if specifiea for the new system, SYS1.ALGLIB, SYS1.C0BLIB, SYS 1.F0RTLIB, 
SYS1.S0RTLIB, SYS 1 . IM AGELIB, and SYS 1.TELCMLIB. 
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If IEWL step (ij) was executed, SYS 1. NUCLEUS must be reallocated (see 
"Reallocating Data Sets") before restarting the step. 

To restart at the beginning of IEWL step ©, any of the following libraries 
that contain system data must be reallocated: SYS1.SVCLIB, SYS1. IMAGELIB, 
SYS1.LINKLIB, SYS1.ALGLIB, SYS 1 . COBLIB, SYS 1 . FORTLIB, SYS 1 . SORTLIB, SYS1.CMDLIB, 
SYS1. NUCLEUS, and SYS l.TELCHLIB. 

If reallocation is not performed, the space already used in the new system 
libraries is not available, and therefore there may not be enough space 
available for these data sets. This is particularly important for those system 
data sets that cannot have a secondary allocation. If more than sufficient 
space was allocated to a data set during the preparation for system generation, 
the IEWL step that failed can be restarted without reallocation. 

It is recommended that the reallocations indicated above be performed when 
restarting from the beginning of IEWL step (3) . To restart from the beginning 
of Stage II, the data sets defined by the OBJPDS, SYSUT1, and SYSUT2 DD 
statements must also be reallocated. 

During an I/O generation, no reallocation is needed to restart a link-edit 
step, unless a step failed because there was not enough space in a system data 
set. If there was not enough space, move the contents of the old library to 
the new library. Copy the data set to a scratch volume using the IEBCOPY 
utility program. Use IEHPROGM to scratch and uncatalog the space for the data 
set on its original volume. Allocate and catalog the required space for the 
data set on its original volume and use IEBCOPY to copy the data set from the 
scratch volume to its original volume. Then restart Stage II at the beginning 
of the link-edit step that failed. 

Restarting IEBCOPY Step 

This IEBCOPY step © copies SYS1.MACLIB, SYS1.TS0MAC, and SYS1.TCAMMAC to 
the new system. To restart at the beginning of this step, the new SYS1.MACLIB 
must be reallocated (see "Reallocating Data Sets") . 

Restarting All Other IEBCOPY Steps 

IEBCOPY step @ copies load modules to the new SYS1.SVCLIB, SYS 1. LINKLIB, 
SYS1.UADS, SYS1.CMDLIB, and SYS1.HELP. No reallocation is needed to restart 
this step, unless the step failed because there was not enough space in a 
system data set. Only the system data set that did not have enough space must 
be reallocated (see "Reallocating Data Sets") , because any member that existed 
in the new system data set will not be moved into it again when the step is 
restarted. 

If the data set that did not have enough space was SYS1.SVCLIB, SYS 1. LINKLIB, 
SYS1.UADS, SYS1.CMDLIB, or SYS 1. HELP, one of the two following procedures must 
be performed: 

• Follow the procedures for restarting with IEWL step (5) as described in 
"Restarting Link Edit Steps" in the "Guidelines for Restarting Stage II 
(TSO Generation) " section. 

• Copy the data set to a scratch volume using the IEBCOPY utility program. 
Scratch and uncatalog the space for the data set on its original volume 
with IEHPROGM. Allocate and catalog the required space for the data set 
on its original volume. Use IEBCOPY to copy the data set from the scratch 
volume to its original volume. Restart Stage II at the beginning of IEBCOPY 
step 03) . 
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IEBCOPY step QJ> copies members to the new SYS1.SVCLIB, SYS1.LINKLIB, 
SYS1.F0RTLIB, SYS1.C0BLIB, SYS1.PL1LTB, SYS1 .TELCMLIB , and SYS1 .IMAGELIB. 

IEBCOPY step @ copies members to SYS1.SVCLIB, SYS1 .FORTLIB, SYS1.C0BLIB, 
SYSl.ALGLIB, SYSl.PLlLIB, SYS1 .LINKLIB, SYS 1. PROCLIB, SYS 1 .SORTLIB, and 
SYS1.PARMLIB. The procedures to restart IEBCOPY step (5) also apply to this 
step. 



IEBCOPY step © copies members to the new SYSI.SfCLIB or SYS 1. LINKLIB. 
procedures to restart IEBCOPY step © also apply to this step. 



The 



Restarting IEHIOSUP, IFCDIPOO, and IEHLIST 

The system data sets do not have to be reallocated when the IBHIOSUP step 
(@ and IEHLIST step Q are restarted. Before the IFCDIPOO step iflji is 
restarted, the DISP parameter of the DD statement for SYS1.L0GREC or 5YS1 .ASRLIB 
must be changed to DISP=(OLD r KEEP), or SYS1.LOGREC and SYS1.ASRLIB must be 
scratched. 

The ASHBLR, SEWL* and IEBCOPY steps must be executed without error before the 
IEHIOSOP step ({J) is executed. 

REALLOCATING DATA SETS 

Reallocating data sets includes the following operations: 

• uncataloging and scratching the space allocated to the data set during 
the preparation for system generation. 

• Allocating new space to the data set and cataloging it. 

The following sections discuss the reallocation of the utility data sets defined 
during Stage I, reallocating new system data sets using the same amount of 
space, and reallocating system data sets using more space. 

The reallocations described in this section may alter the order in which the 
new system data sets were originally allocated. If this order is important, 
the IEBCOPY utility program can be used after system generation to rearrange 
the new system data sets. 



Reallocation of OBJPDS 



Use the following statements to reallocate the utility data set specified by 
the OBJPDS DD statement during Stage I. These statements are coded when more 
than one assembler step is executed and the generation process is to be 
restarted from the beginning. 



//OBJPDS 

//STEP1 

//OBJPDS 

//STEP2 

//OBJPDS 

// 



JOB 

EXEC 

DD 

EXEC 

DD 



PGM=IEFBR14 -SCRATCH OBJPDS- 
DSNA ME=SYS 1 . name , DISP= (OLD, DELETE) 
PGM=IEFBR14 -REALLOCATE OBJPDS- 
(Parameters for OBJPDS in Stage I input deck) 



Figure 36. Control Statements to Reallocate the Utility Data Set for OBJPDS 
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In the preceding statements: 

• The DSNAME parameter of the first OBJPDS DD statement must contain the 
name given to the utility data set in the input deck to Stage I. 

• The second OBJPDS DD statement must contain the same parameters that it 
contains in the Stage I input deck. 



Reallocation of SYSUT1, SYSUT2, SYSUT3, and SYSUTU 

The operations to be performed depend on whether UTDISP=UNCATLG or DTDISP=DELETE 
was specified in the GENERATE macro instruction. 

Use the following statements to recatalog the utility data sets when 
DTDISP=ONCATLG was specified: 

//CATLG JOB -UTDISP=UNCATLG- 

//STEP EXEC PGM=IEHPROGM 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD * 

CATLG DSNAME=SYS1.name,V0L=unit=serial 
/* 

Figure 37. Control Statements to Recatalog the Utility Data Set When 
UTDISP=UNCATLG 

In the preceding statements: 

• Use one CATLG statement for each utility data set to be recataloged. 

• The DSNAME parameter must contain the name given to the utility data set 
in the input deck to Stage I. 

• The unit and serial number in the VOL parameter must correspond to those 
specified for the utility data set in the input deck to Stage I. 

Use the following DD statements to allocate space and recatalog the utility 
data sets when UTDISP=DELETE was specified: 

//ALLOC JOB -UTDISP=DELETE- 

//STEP EXEC PGM=IEFBR14 

//SYSUT1 DD (Parameters for SYSUT1 in Stage I input deck) 

//SYSUT2 DD (Parameters for SYSUT2 in Stage I input deck) 

//SYSUT3 DD (Parameters for SYSUT3 in Stage I input deck) 

//SYSUTU DD (Parameters for SYSUT4 in Stage I input deck) 
// 

Figure 38. Reallocate and Recatalog the Utility Data Sets When UTDISP=DELETE 

In the preceding statements: 

• Omit the SYSUT1 and SYSUT2 DD statements if only the data sets defined 
by the SYSUT3 and SYSUT4 DD statements in Stage I are to be reallocated. 

• Omit the SYSUT3 DD statement if only the data sets defined by the SYSUT1 
and SYSUT2 DD statements in Stage I are to be reallocated. 
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The SYS0T1, SYSUT2, SYS0T3, and SYSUT4 DD statements must contain the same 
parameters that they contain in the Stage I input deck. 



Reallocating the Same Space 

The input deck for scratching and reallocating space to the new system data 
sets must contain the following statements. The statements must be in the 
order shown. 

1. JOB statement. 

2. EXEC statement with the PGM=IEHPROGM parameter. 

3. SYSPRINT DD statement defining the system output unit. 

4. DD statement defining the unit and serial number of the generating system- 
residence volume: 

//GENRES DD UNIT=unit, VOLOME=SER=serial, DISP=OLD 

5. DD statement defining any other permanent volume on which data sets to 
be reallocated reside: 

//ddname DD UNIT=unit, VOLOME=SER=serial,DISP=OLD 

6. DD statement for each type of removable device on which data sets to be 
reallocated reside: 

//ddname DD UNIT= (unit, , DEFER) , VOLOME=PRIVATE, DISP=OLD 

7. DD * statement (SYSIN) . 

8. SCRATCH and an ONCATLG statement for each new system data set to be 
reallocated. The SCRATCH and ONCATLG statements must have the following 
format: 

SCRATCH DSNAME=dsname, VOL=device=serial, PURGE 
ONCATLG DSNAME=dsname,CVOL=device=serial 

where CVOL designates the new system-residence volume. 

9. /* statement. 

10. EXEC statement with the PGM=IEHPROGM parameter. 

11. GENRES DD statement (described above). 

12. DD statement for each permanent device (described above) . 

13. DD statement for each type of removable device (described above). 

14. SYSPRINT DD statement defining the system output unit. 

15. DD statement for each of the new system data sets to be reallocated. This 
DD statement must be the same used in the input deck for the preparation 
for system generation. 

16. DD * statement (SYSIN). 
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17. CATLG statement for each new system data set to be reallocated. The CATLG 
statement must be the same used in the input deck for the preparation for 
system generation. 

18. /* statement. 

For example, SYS 1. SVCLIB and SYS 1. LINKLIB must be reallocated. Figure 39 shows 
the DD statements that define these two libraries during the preparation for 
system generation: 

//SVCLIB DD DSNAME=SYS1. SVCLIB, VOLUME=(, RETAIN, SER=AAA111) , X 

// ONIT=2301,DISP=( r KEEP) ,SPACE=(TRK, (40,10,75) , X 

// LABEL=EXPDT=99350,DCB= (DSORG=PO[J, RECFM=U, BLKSIZE= 1024) 

//LINKLIB DD DSNAHE=SYS 1 . LINKLIB, V0LUME= (, RETAIN, SER=AAA 1 1 2) , X 

// UNIT=2311, DISP=(, KEEP) ,SPACE=(CYL, (125,10,100) ) , X 

// LABEL=EXPDT=99350,DCB= (RECFM=TJ, BLKSIZE=3625) 

Figure 39. Example of Reallocation for SYS1. SVCLIB and SYS 1. LINKLIB 

The generating system-residence volume is a 231 1 volume whose serial number 
is 111111. Figure 40 shows the input deck for this reallocation. 

-REALLOCATE ON SAME SPACE- 
PGM=IEHPROGM -SCRATCH- 

0NIT=231 1 , VOLUME=SER= 111111, DISP=OLD 
UNIT=2301,VOLUME=SER=AAA111,DISP=OLD 
UNIT=(231 1,, DEFER) , VOLUME=PRIVATE, DISP=OLD 
SYSOUT=A 
* 

DSNAME=SYS1.SVCLIB,VOL=2301=AAA111 
DSNAME=SYS1 . SVCLIB, CVOL=230 1=AAA1 1 1 
DSNAME=SYS1.LINKLIB,V0L=2311=AAA112 
DSNAME=SYS1. LINKLIB, CVOL=230 1=AAA 1 11 

PGM=IEHPROGM -ALLOCATE- 

0NIT=23 1 1 , VOLOME=SER= 111111, DISP=OLD 

DNIT=2301,VOLUME=SER=AAA1 11,DISP=OLD 

UNIT=(231 1,, DEFER) , VOL0ME=PRIVATE,DISP=OLD 

SYSOUT=A 

DSNAME=SYS1. SVCLIB, VOLUME= (, RETAIN, SER=AAA1 11) , 

UNIT=2301,DISP=(,KEEP) ,SPACE= (TRK, (40,10,75)) , 

LABEL=EXPDT=99350,DCB=(RECFM=tJ,BLKSIZE=10 24,DSORG=POU) 

DSNAME=SYS1 . LINKLIB, VOLUME= (, RETAIN, SER=AAA1 1 2) , 

UNIT=2311,DISP=(,KEEP) , 

SPACE=(CYL, (125,10, 100) ) ,LABEL=EXPDT=99350, 

DCB= (RECFM=0,BLKSIZE=3625) 

DSNAME=SYS1. SVCLIB, CVOL=230 1 = AAA 1 1 1 , VOL=230 1 = AAA1 1 1 
DSNAHE=SYS1. LINKLIB, CVOL=230 1=AAA 1 1 1 , VOL=231 1=AAA 112 



//SAME 


JOB 


//STEP1 


EXEC 


//GENRES 


DD 


//NEWRES 


DD 


//LINVOL 


DD 


//SYS PRINT 


DD 


//SYSIN 


DD 


SCRATCH 


ONCATLG 


SCRATCH 


UNCATLG 


/* 




//STEP2 


EXEC 


//GENRES 


DD 


//NEWRES 


DD 


//LINVOL 


DD 


//SYSPRINT 


DD 


//SVCLIB 


DD 


// 




// 




//LINKLIB 


DD 


// 




// 




// 




//SYSIN 


DD 


CATLG 


CATLG 


/* 




// 





Figure 40. Reallocating on Same Space 



Reallocating With More Space 



The method for reallocating with more space depends on whether the space for the 
data set must be continuous. If the space need not be continuous, follow the 
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procedure described in "Reallocating on the Same Space," changing the SPACE 
parameter of the DD statement (statement 15) for the new system data set in the 
second step. This same procedure can be followed for a continuous data set if 
there is enough continuous space for the new allocation elsewhere on the volume, 



The second case can be illustrated with the following example, 
new system volumes is organized as shown in Figure 41. 



One of the 




Figure 41. Reallocation on Same Volume 



Not enough space was allocated for SYS1.PARMLIB, and there is not enough 
continuous space after SYS1.PL1LIB for a new allocation of SYS 1.PARMLIB. One 
of two procedures can be followed to free space for the new allocation for 
SYSl.PARfSLIB. 

• If there is no system data in SYS1.PARMLIB, SYS1. FORTLIB, and SYS1.PL1LTB, 
follow the procedures described in "Reallocating in the Same Space" to 
reallocate SYS1.PARMLIB, SYS1 .FORTLIB, and SYS1.PL1LIB. Correct the SPACE 
parameter in the DD statement for SYS1.PARMLIB. 

• If there is system data in SYS1.PARMLIB, SYS1 .FORTLIB, or SYS1.PL1LIB 
follow these procedures: 

Copy the library that contains system data onto a scratch volume by using 
the IEBCOPY utility program. 

Follow the procedures described in "Reallocating in the Same Space" to 
scratch SYS1. PARMLIB, SYS1 .FORTLIB, and SYS1.PL1LIB, correcting the SPACE 
parameter in the DD statement for SYS1.PARHLIB. 

Copy the library that contains system data from the scratch volume to its 
original volume. 

If a system data set (continuous or not) contains system data, and if there 
is enough space elsewhere in the volume, the following procedure can be used: 

1. Rename the system data set. 

2. Allocate and catalog space for the system data set (with its correct name) 
on the same volume. 

3. Copy the data in the renamed data set onto the newly allocated data set. 

4. Scratch and uncatalog the renamed data set. 
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Figure 42 is an example of reallocation on the same volume of a system data 
set that contains system data. The system data set to be reallocated is 
SYS1. PARMLIB. It was allocated space during the preparation for system 
generation with the following DD statement: 

//PARMLIB DD DSNAME=SYS 1. PARMLIB, VOLUME= (, RETAIN, SER=SYSTEM) , X 
// UNIT=2301,DISP=(,KEEP) ,SPACE=(TRK, (1,,1) ,,CONTIG) , X 

// LABEL=EXPDT=99350,DCB=(RECFM=F,BLKSIZE=80) 

The new system-residence volume is a 2301 volume whose serial number is SYSTEM, 
The renamed SYS 1. PARMLIB will be called SYS 1. HARRY. The generating system- 
residence volume is a 2311 volume whose serial number is 111111. 

//MOVE JOB -REALLOCATE WITH DATA- 

//STEP1 EXEC PGM=IEHPROGM -RENAME- 

//SYSPRINT DD SYSODT=A 

//GENRES DD UNIT=23 1 1 , VOLOME=SER= 1 1 1 1 1 1 , DISP=OLD 

//NEWRES DD ONIT=230 1 , VOLOME=SER=SYSTEM,DISP=OLD 

//SYSIN DD * 

RENAME DSNAME=SYS1. PARMLIB, VOL=2301=SYSTEM, X 

NEWNAME=SYS1. HARRY 

ONCATLG DSNAME=SYS1. PARMLIB, CVOL=2301=SYSTEM 

CATLG DSNAME=SYS1. HARRY, CVOL=2301=SYSTEM,VOL=2301=SYSTEM 
/* 

//STEP2 EXEC PGM=IEHPROGM -REALLOCATE- 

//SYSPRINT DD SYSOUT=A 

//GENRES DD UNIT=23 1 1 , VOLUME=SER= 1 11 1 1 1 , DISP=OLD 

//NEWRES DD DNIT=2301 , VOL0ME=SER=SYSTEM,DISP=OLD 

//PARMLIB DD DSNAME=SYS1 . PARMLIB, VOLUME= (, RETAIN, SER=SYSTEM) , X 

// ONIT=2301,DISP=(,KEEP) , X 

// SPACE=(TRK, (5,,1) ,,CONTIG) ,LABEL=EXPDT=99350, X 

// DCB=(RECFM=F,BLKSIZE=80) 

//SYSIN DD * 

CATLG DSNAHE=SYS1. PARMLIB, CVOL=2301=SYSTEM,VOL=2301=SYSTEM 
/* 

//STEP3 EXEC PGM=IEBCOPY -COPY- 

//SYSPRINT DD SYSOUT=A 

//SYSUT1 DD DSNAME=SYS 1. HARRY, VOLOME=SER=SYSTEM,ONIT=230 1 , X 

// DCB=(RECFM=F,BLKSIZE=80) 

//SYS0T2 DD DSNAME=SYS1. PARMLIB, VOLUME=SER=SYSTEM,UNIT=230 1 , X 

// DCB=(RECFM=F,BLKSIZE=80) 

//SYSIN DD DUMMY 

//STEPU EXEC PGM=IEHPROGM -SCRATCH- 

//SYSPRINT DD SYSOUT=A 

//GENRES DD UNIT=23 1 1 , VOLUME=SER= 1 11 1 1 1 , DISP=OLD 

//NEWRES DD UNIT=230 1 ,VOL0ME=SER=SYSTEM, DISP=OLD 

//SYSIN DD * 

SCRATCH DSNAME^SYSI. HARRY, VOL=230 1=SYSTEM 

UNCATLG DSNAME=SYS1. HARRY, VOL=2301=SYSTEM 
/* 
// 

Figure 42. Reallocate Data Sets With System Data 



Restart Procedures 93 



SYS1.SYSJ0BQE Considerations 

If the job stream is too large for the SYS1. SYSJOBQE of the generating system, 
one of the following procedures can be followed: 

• Convert the job stream into two or more jobs 

• Reformat the job gueue 

• Enlarge SYS 1. SYSJOBQE 

The job stream can be converted into two or more jobs by placing additional 
JOB cards throughout the job stream. For example, you might insert a JOB card 
just before the first IEWL step. This method reguires that the job stream 
be in cards. 

A description of the values to specify when reformatting can be found in the 
"MVT Job Queue Formatting" section of the OS System Programmer* s Guide. 

The size of SYS 1 . SYSJOBQE can be changed following this procedure: 

1. Determine the appropriate size of SYS 1. SYSJOBQE using the formula given 
in OS Storage Estimates. 

2. Run the job shown in Figure 43. 

//LASTJOB JOB 

//STEP EXEC PGM=IEHPROGM 

//DUMMY DD DSNAME=SYS1. DUMMY, VOLUME=(, RETAIN, SER=serial) , X 

// UNIT=unit,DISP=(,CATLG) ,SPACE=(TRK, (XXX) ,,CONTIG) 

//GENRES DD UNIT=unit, VGLUME=SER=serial, DISP=OLD 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD * 

SCRATCH DSNAME=SYS1. SYSJOBQE, VOL=unit=serial 

UNCATLG DSNAME=SYS1. SYSJOBQE 

RENAME DSNAME=SYS1. DUMMY, VOL=unit=serial, X 

NEWNAME=SYS 1 .SYSJOBQE 

CATLG DSNAME=SYS1. SYSJOBQE, VOL=unit=serial 
/* 
// 

Figure 43. Control Statements to Change SYS1 .SYSJOBQE 

In the preceding statements, 

• SYS I. DUMMY is allocated space on the same volume on which the generating 
SYS1. SYSJOBQE resides. The amount of space allocated for SYS 1. DUMMY must 
be the appropriate size for SYS 1. SYSJOBQE. 

• The GENRES DD statement defines the generating system-residence volume. 

• The UNCATLG and CATLG statements should be omitted if SYS 1 . SYSJOBQE is 
not cataloged in the generating system. 

• The VOL parameter of the utility statements defines the volume on which 
SYS1. SYSJOBQE resides. 

3. Stop the system and restart (IPL again) . 
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Testing the New System 



This section describes the sample programs provided by IBM to test the 
functioning of various components of the new system after system generation, 

A description of the sample program, its operating instructions, and a list 
of the output results are provided. 
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The sample programs are contained in SYS1.SAMPLIB of the starter operating 
system package- The "System Generation Using the Starter Operating System" 
section describes the procedure used to punch sample program card decks from 
SYS1.SAMPLIB. These decks can then be used whenever an operating system 
component is to be tested. 

The following list shows the names of the sample programs provided in 
SIS1.SAHPLIB and the components they test: 

Program Component 

IEXSAMP ALGOL 

IKFSAMP American National Standard COBOL 

IEUESP Assembler F 

SAMP327L BTAM-Local 3270 Display System 

SAMP327R BTAM-Remote 3270 Display System 

IEPSAMP COBOL E 

IEBDATGN Data Generator Sample Program 

IKDSAMPL Data transmission and conversion subroutines for FORTRAN IV 

IBCDASDI Direct Access Initialization 

IBCDMPRS Direct Access Dump Restore 

IEYSP FORTRAN G and H 

SAMP2250 Graphics - 2250 Display Units 

SAMP2260 Graphics - 2260 Display Stations 

COBSAMP Graphic Subroutine Package for COBOL 

GSPSAMP Graphic Subroutine Package for FORTRAN IV 

PL1SAMP Graphic Subroutine Package for PL/I 

DRISAMP IEHDASDR system utility program 

Loader Program Test Program 

IEMSP2 PL/I F 

RPGSMPL RPG 

SAMACTRT Sample Account Routine 

IERSP Sort/Merge 

System Management Facilities Sample Programs (see below) 

IHGSAMP Update Analysis Program 

USERLABL User Label Sample Program 

DASDI, DOMPREST, and RECOVRBP (alias for IBCDASDI, IBCDMPRS, IBCRCVRP 
respectively) are included in SYS1.SAMPLIB. These programs are identical to 
IBCDASDI, IBCDMPRS, and IBCRCVRP. Either DASDI or IBCDASDI, either DOMPREST 
or IBCDMPRS, or either RECOVREP or IBCRCVRP can be specified in a PUNCH 
statement. 

The following pages contain descriptions of the sample programs, operating 
instructions, and a description of the program execution results, except for 
the BTAM sample programs and the system management facilities (SMF) sample 
programs. These sample programs are in OS Basic Telecommunications Access 
Method , and OS SMF , respectively. More detailed operating instructions for 
all the sample programs except the SMF sample programs are in OS Operator's 
Reference t 

Note; The DD statements of the sample programs specify 0NIT=2311. If the 
system data sets affected by the sample program do not reside on a 2311, the 
ONIT parameter should be changed accordingly. If the system data set is 
cataloged, the ONIT parameter of the corresponding DD statement can be deleted 
rather than changed. 
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ALGOL Sample Program (IEXSAMP) 

The IEXSAMP card deck (punched from SYS1. SAMPLIB) consists of: 

1. Job control language statements for an ALGOL compilation, a link-edit, 
and execution. 

2. ALGOL sample program source statements. 

The sample program generates the first twenty lines of Pascal *s Triangle. 
Comments included in the program may be used for checking the results. (The 
sample program is included as an example in OS ALGOL Language. ) 

OPERATING INSTRUCTIONS 

1. Mount the operating system and an initialized scratch pack. 

2. Set the load address switches and press the Initial Program Load key to 
load the operating system. 

3. Place the IEXSAMP card deck in the card reader, ready the reader, and press 
the End-of-File key. 

4. Ready the printer. 

5. Execute the job. 

OUTPUT 

The normal output from the compiler is: 

1. A list of all job control language statements that apply to the compiler. 

2. A list of all source statements supplemented by a count of the semicolons 
occurring in the program. 

3. The identifier table in symbolic form, giving details of all identifiers 
used in the program. 

4. Information on main-storage requirements at execution time. 
The normal output from the linkage editor will be: 

1. A list of all job control language statements that apply to the linkage 
editor. 

2. A cross-reference table of the load module. 
The normal output at execution time will be: 

1. A list of all job control language statements that apply to the execution. 

2. The first twenty lines of Pascal's Triangle, corresponding to the comments 
included in the source statements. 

A more detailed description of the system output is contained in OS ALGOL 
Programmer's Guide. 
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American National Standard Cobol, X3.23-1968 Sample Program (IKFSAMP) 

The IKFSAMP card deck (punched from SYS1. SAMPLIB) consists of: 

1. Job control language statements to call a cataloged procedure to compile, 
link-edit, and execute the sample program. 

2. COBOL sample program source statements. 

The sample program tests the operation of the IBM American National Standard 
COBOL compiler; it generates an output data set on tape and then reads, 
processes, and exhibits this data set. The program uses the COBOL verbs 
IF, OPEN, READ, WRITE, CLOSE, DISPLAY, MOVE, ADD, STOP, GO TO, PERFORM, 
NOTE, TRACE, and EXHIBIT. A complete output listing of the program is 
in the publication, OS American National Standard COBOL Programmer's Guide. 

OPERATING INSTRUCTIONS 

1. Mount the operating system. 

2. Set the load address switches and press the Initial Program Load key to 
load the operating system. 

3. Place the IKFSAMP deck in the card reader, ready the reader, and press 
the End-of-File key. 

«»• Ready the printer. 

5. Execute the job. 

O0TP0T 

1. Listing of all job control language statements 

2. Listing of the source program 

3. Listing of: 

a. Heading including date and level 

b. Source program 

c. Data map of the Data Division 
ft. Module map and cross-reference list 
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Assembler F Sample Program (IEUESP) 

The IEUESP card deck (punched froi SYS1 .SAMPLIB) is the sample program source 
deck. 

The sample problem demonstrates the use of the assembler and serves as a minimal 
test of the functioning of the assembler. In addition, it provides sample 
coding that demonstrates the definition and use of user-written macro 
instructions, the calling of system macro instructions, and the proper method 
of saving and restoring registers upon entry to and exit from a problem program. 

The input is assembled into the program in the form of a table (TABLE) and 
a list (LIST) of entries that are to be compared with the table entries. Each 
item in the table contains an argument name such as ALPHA and space in which 
information concerning that name is to be placed. Each entry in the LIST 
contains an argument name and function values. The formats of the TABLE entries 
and the LIST entries are different, and both formats are described by means 
of DSECTs. The program searches the TABLE for an argument name in the list. 
If a match is found, the function values are reformatted and moved to the 
appropriate TABLE entry. If an argument name in the LIST cannot be found in 
the TABLE, a switch is set in the LIST entry. After all LIST entries have 
been processed, both the LIST and TABLE areas are compared with TESTTABL, which 
contains the predefined results. If the two are equal, the routine is executed 
properly and a message is written to indicate this. 

The program for the assembler may be -called by the IBM-supplied cataloged 
procedure ASMPCLG in the following manner: 

//jobname JOB 

//stepname EXEC PROC=ASMFCLG 

//ASM.SYSIN DD * 

Sample program source deck 
/* 

This procedure calls for an assembly, link-edit, and execution of the sample 
program. A more detailed explanation of the contents of the procedure and 
use of the assembly program is given in OS Assembler (F) Programmer's Guide. 

OPERATING INSTRUCTIONS 

1. Mount the operating system and an initialized scratch pack. 

2. Set the load address switches and press the Initial Program Load 
key to load the operating system. 

3. Place the sample program source deck in the card reader, ready the 
reader, and press the End-of-File key. 

4. Ready the printer. 

5. Execute the job. 

OUTPUT 

The check for the successful execution of the sample program is a message on 
the operator* s console. The message says either "ASSEMBLER SAMPLE PROGRAM 
SUCCESSFUL" or "ASSEMBLER SAMPLE PROGRAM UNSUCCESSFUL." The program gives 
a normal return to the operating system with a return code of 0. 
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COBOL E Sample Program (IEPSAMP) 

The IEPSAMP card aeck (punched from SYS1.SAMPLIB) consists of: 

1. Job control language statements to execute the COBOL E cataloged procedure 
COBECLG to compile, link-edit, and execute. 

2. COBOL sample program source statements. 

3. DD statements for tape data sets required at execution time. 

The sample program tests the COBOL compilers ability to write to and read 

from tape, checking proper data alignment where the data is a mixture of DISPLAY 

COMPUTATIONAL and C0MPDTATI0NAL-3. 

The verbs used in this program are OPEN, CLOSE, READ, WHITE, PERFORM, IF, MOVE, 
GO TO, DISPLAY, and ADD. There are 575 source statements. 

OPERATING INSTRUCTIONS 

1. Mount the operating system and an initialized scratch pack. 

2. Mount unlabeled tapes on 182, 183, and 282. 

3. Set the load address switches and press the Initial Program Load key to 
load the operating system. 

4. Place the IEPSAMP card deck in the card reader, ready the reader, and press 
the End-of-File key. 

5. Ready the printer. 

6. Execute the job. 

OUTPUT 

1. The scheduler reads, processes, and prints (on the device specified as 
SYSOUT by the operator) all job control language statements. 

2. The compiler reads and lists the source program on the device specified 
as SYSOUT by the operator. 

3. The compiler prepares and lists the following (on SYSOUT) : 

a. Heading including date and level 

b. The source program 

c. A data map of the Data Division 

d. An object code listing (PMAP) of the Procedure Division 

ft-. The linkage editor prepares and lists the following (on SYSOUT) : 

a. A module map 

b. A cross-reference list 

5. The COBOL load module lists the following (on SYSOUT) : 

GROUP B LEVEL P TEST CASE 1 
END OF PROGRAM 
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Data Generator Sample Program (IEBDATGN) 

The IEBDATGN card deck, punched from SYS1.SAMPLIB, consists of: 

1. Job control language statements for the execution of the data generator 
system utility program 

2* Comment statements describing the control cards for the system utility 
program 

3. The sample program utility statements 

The sample program generates patterns of data on the printer illustrating the 
generating capabilities of the data generator system utility program and the 
various ways of altering this data. 

OPERATING PROCEDURES 

1. Hount the operating system. 

2. Set the load address switches and press the Initial Program Load key to 
load the operating system. 

3. Place the IEBDATGN card deck in the card reader, ready the reader, and 
press the End-of-File key. 

4. Ready the printer. 

5. Execute the job. 

OUTPUT 

1. A list of all job control language statements that apply to the execution. 

2. The comment statements explaining the function performed by the system 
utility control cards. 

3. The data generator sample program utility statements. 

4. The generated output showing the results of the action parameter. 

5. A second group of utility statements. 

6. The generated output showing the results of the picture and index parameter 
of the data generator system utility program. 



102 OS System Generation 



Data Transmission and Conversion Subroutines for FORTRAN IV Sample 
Program (IKDSAMPL) 

The System/360 portion of the IKDSAMPL sample program for data transmission 
and conversion subroutines can be punched from SYS1.SAMPLIB. The IKDSAMPL 
card deck consists of: 

1. The following job control language statements, which call the FORTGCLG 
cataloged procedure to compile, link-edit, and execute the program when 
the FORTRAN G compiler is used in the operating system. 

//PTOPSAMP JOB 360T1 130, SAMPLE, MSGLEVEL=1 
//PTOPSTEP EXEC FORTGCLG, PARM. FORT= (NODECK, MAP, LOAD) 
//FORT.SYSIN DD * 

If the FORTRAN H compiler is to be used, the FORTGCLG parameter of the 
EXEC statement must be changed to FORTHCLG. 

2. A sample program input symbolic deck. (The contents of this deck are shown 
in IBM System/360 Operating System and 1130 Disk Monitor System: 
System/360-1130 Data Transmission for FORTRAN. ) 

3. The following cards after the FORTRAN language END card: 

/* 

//LKED.SYSLMOD DD SPACE= ( 1024, (50, 20, 1) ,RLSE) 

/* 

//GO. SYS ABEND DD SYSOUT=A 

//GO.FT09F001 DD DNIT=XXX 

//GO.SYSIN DD * 

AXLEP1 (This is the data card that identifies the password) 

/* 

The UNIT parameter of the GO.FT09F001 DD statement must be changed to 
specify the appropriate address or symbolic name previously assigned to 
the 1130 system with which this sample program is to communicate. You 
must then substitute this newly punched card for the GO.FT09F001 DD card 
in the existing card deck. 

OPERATING INSTRUCTIONS 

To process the PTOP sample program card deck, the following steps are necessary: 

1. Ensure that the 1130 portion of the sample program for the data transmission 
and conversion subroutines (program number 1130-LM-011) exists in an 
associated 1130 system, as described in IBM Svstem/360 Operating System 

and 1130 Disk Monitor System: System/360-1130 Data Transmission for FORTRAN. 

2. Place the PTOPSAMP card deck in the card reader. 

3. Mount the operating system. 

4. Set the load address switches and press the Initial Program Load key to 
load the system. 

OOTPQT 

The 1130 program prints out the results of the computations (the weight 
distributions on the front and rear axles of a truck) . From these results, 
the optimum dimensions for the front and rear axles of a truck can be 
determined. 
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FORTRAN G and H Sample Program (IEYSP) 

The IEYSP card deck (punched from SYS1.SAMPLIB) consists of: 

1. Job control language statements for a FORTRAN G or H compilation. 

2. FORTRAN sample program source statements. 

3. Job control language statements for link-edit and execution of the sample 
program. 

4. A data card for FORTRAN sample program execution. 

The sample program consists of one main program and one function subprogram, 
which together compute and print out binomial coefficients. The deck is 
composed of the following source statements: 



Main Program 


Subprog 


ram 


Comments 42 


19 




Specification 1 


1 




Format 5 






Read/Write 5 






Control 8 


13 




Arithmetic 2 


13 




Total 63 


46 





The program processes one data card as its input. The comment cards show a 
complete list of the expected output from the execution of the program and 
may be used for checking the output. 

OPERATING INSTRUCTIONS 

1. Mount the operating system and an initialized scratch pack. 

2. Set the load address switches and press the Initial Program Load key to 
load the operating system. 

3. Place the IEYSP card deck in the card reader, ready the reader, and press 
the End-of-File key. 

4. Ready the printer. 

5. Execute the job. 

OUTPUT 

1. The scheduler will read, process, and print (on the device specified as 
SYSOUT by the operator) all job control statements. 

2. The compiler will read and list the source program on the device specified 
as SYSOUT by the operator. 

3. The compiler will prepare and list the following (on SYSOUT) : 

a. Heading, including date and level 

b. The source program 

c. Storage map including size of COMMON and size of program 

d. The generated object code 

4. The linkage editor will prepare and list (on SYSOUT) a storage map including 
the relative address of each external reference. 

5. The FORTRAN load module will list (on SYSOUT) the results of execution. 
The results should correspond to the comments in the source program. 
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Graphics Sample Programs (SAMP2250 and SAMP2260) 

The SAMP2250 card deck (sample program to exercise the 2250 display unit) and 
the SAMP2260 card deck (sample program to exercise the 2260 display station, 
local) can be punched from SYS1.SAMPLIB. 

Each card deck consists of: 

1. Appropriate job control language statements. Included is a cataloged 
procedure (ASHFCLG) to assemble, link-edit, and execute the compiled 
program. Before compiling either deck, the four override cards below must 
be added to the end of the deck after the assembler language END card. 

/* 

//LKED.SYSLIB DD DSNAME=SYS0.LINKLIB,DISP=OLD 

//GO. GRAPHIC DD UNIT= 2250-1 

or 

//GO. GRAPHIC DD UNIT= ( 2260- 1 , 2 ) 

/* 

In the preceding statements, the underlined values must be replaced with 
the device type of the 2250 or 2260 being tested. (See Appendix A.) Note 
that the GO. GRAPHIC DD statement for the 2260 specifies two devices. (For 
further information about specifying more than one device, see OS Job 
Control Language Reference. ) 

2. Sample program input symbolic deck. 

OPERATING INSTRUCTIONS 

1. Ensure that the graphic device is "on." 

2. Place the sample program deck in the card reader. 

3. Mount the operating system. 

4. Set the load address switches and press the Initial Program Load key to 
load the system. 

5. Perform the assemble, link-edit, and go procedure. 

6. Follow the instructions that appear on the display screen. 

OUTPUT 

The displays that appear on the 2250 display unit are shown in Figure 44. 
The displays that appear on the 2260 display station are shown in Figure 45. 
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a. First Display 



THIS PROGRAM WILL PLOT A GRID WITH CORNERS AT 2400,2400-2400 ,4000- 
4000,4000-4000,2400. IT WILL PLOT 90 DEGREES OF ARC WHOSE RADIUS IS 
1200 RASTER UNITS. IT ILLUSTRATES THE USE OF ORDER MACROS TO CREATE 
THIS DISPLAY AND PORS TO CREATE THE NEXT DISPLAY. 

DEPRESS KEY D AND THEN THE END KEY ON THE ALPHAMERIC KEYBOARD TO 
INITIATE THE NEXT DISPLAY. 



b. Second Display 



















































































































































THIS DISPLAY ILLUSTRATES THE OUTPUT OF THE GCGI 
AND GCPRNT PROBLEM ORIENTED ROUTINES. 

DEPRESS KEY E AND THEN THE END KEY ON THE ALPHi 
TERMINATE THIS SAMPLE PROGRAM. 


*ID, Gf 
iMERIC 


IRC, 
KEYBOA 


RD TO 













c. Third Display 



Figure 44. 2250 Displays 
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a. First Display 




b. Second Display 




c. Third Display 



Figure 45. 2260 Displays 
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Graphic Subroutine Package for FORTRAN, COBOL, and PL/ 1 Sample 
Program (GSPSAMP, COBSAMP, and PLISAMP) 

There are two sample programs for the Graphic Subroutine Package: GSPSAMP and 
PL1SAMP written in FORTRAN IV and PL/I, respectively. Both programs produce 
the same displays and perform the same functions. 

The GSPSAMP card deck (punched from SYS1. SAMPLIB) consists of: 

1. The following job control language statements that call the FORTGCLG 
cataloged procedure to compile, link-edit, and execute the program when 
the FORTRAN G compiler is used in the operating system: 

//GSPSAMY JOB 123U567, GSPSAMP, MSGLEVEL=1 

//SAMPL EXEC FORTGCLG, PARM. FORT= (NODECK, MAP, LOAD) 

//FORT.SYSIN DD * 

If the FORTRAN H compiler is to be used* the FORTGCLG parameter of the 
EXEC statement must be changed to FORTHCLG. 

2. A sample program input symbolic deck. 

3. The following cards after the FORTRAN-language END card: 

/* 

//LKED.SYSIN DD * 

INCLUDE SYSLIB(IHCGSP03) 

/* 

//GO. SYS ABEND DD SYSODT=A 

//GO.FT10F001 DD UNIT= (2250-1) 

//GO.SYSIN DD * 

X 

NUM1NUM2NUM3NUM4NUM5NUM6NUM7NUM8 

/* 

The PL1SAMP card deck (punched from SYS 1. SAMPLIB) consists of: 

1. Appropriate job control language statements that call a cataloged procedure 
(PL1LFCLG) to compile, link-edit, and execute the program. The following 
cards are reguired after the PL/I language END card: 



/* 




//LKED.SYSIN 


DD * 


INCLUDE 


SYSLIB(IHEGSPOI) 


INCLUDE 


SYSLIB(IHEGSP02) 


INCLUDE 


SYSLIB(IHEGSP03) 


/* 




//GO. PL 1 DUMP 


DD SYSOUT=A 


//GO.SYSUDUMP 


DD SYSOUT=A 


//GO.FT10F001 


DD UNIT=XXX 


// 


address) 


/* 





(where xxx is the 2250 unit 



2. A sample program input symbolic deck. 
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OPERATING INSTRUCTIONS 

1. Ensure that the graphic device is "on." 

2- Place the sample program deck in the card reader. 

3. Mount the operating system. 

4. Set the load address switches and press the Initial Program Load key to 
load the system. 

5. Perform the compile, link-edit, and go procedure. 

6. Follow instructions that appear with the sample program in OS GSP for 
FORTRAN and PL/I. 

OUTPUT 

The displays that appear on the 2250 display unit are shown in Figure 46. 
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Figure 46. Display for GSP Sample Program 
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IEHDASDR Sample Program (DRISAMP) 

The DRISAMP card deck (punched from SYS1. SAMPLIB) consists of: 

1. Job control language statements for execution of the IEHDASDR system utility 
program 

2. IEHDASDR sample program utility statements 

The sample program initializes a direct-access volume chosen by the 
installation, dumps this volume to a magnetic tape volume also chosen by the 
installation, and restores from that magnetic tape volume to the dumped direct- 
access volume. 

Two of the DRISAMP DD statements must be changed to indicate the direct-access 
volume and tape volume chosen by the installation. The statements are: 

//DADEV DD UNIT=XXXX,VOLUME=SER=YYYYYY,DISP=OLD 

//TAPDEV DD UNIT=MHMM,VOLUME=SER=ABCXYZ,DISP=OLD,LABEL=(,NL) 

where: 

XXXX 

is the unit name of the direct-access volume (See Appendix B) . 

YYYYYY 

is the serial number of the direct-access volume. The system-residence 
volume must not be specified. 

MMHM 

is the unit name of the magnetic tape volume (see Appendix B) . 

The TAPDEV DD statement defines an unlabeled tape with an external serial 
number. If desired, this external serial number (ABCXYZ) may be changed. 

OPERATING INSTRUCTIONS 

1. Mount the operating system and the desired direct-access volume. 

2. Mount a magnetic tape volume (unlabeled) . 

3. Set the load address switches and press the Initial Program Load 
key to load the operating system. 

4. Place the DRISAMP card deck in the card reader, ready the reader, 
and press the End-of-File key. 

5. Ready the printer. 

6. Execute the job. 

OUTPUT 

1. A list of all job control language statements that apply to execution. 

2. The following appears on SYSOUT: 

ANALYZE TODD=DADEV,VTOC=00050,EXTENT=00010,PURGE=YES 
DUMP FROMDD=DADEV,TODD=TAPDEV 
IEH8061 ANALYZE OF DDNAME=DADEV IS COMPLETE. VOLUME SERIAL NO=YYYYYY 

RESTORE FROMDD=TAPDEV,TODD=DADEV 

IEH8061 DUMP TO DDNAME=TAPDEV IS COMPLETE 

IEH8061 RESTORE TO DDNAME=DADEV IS COMPLETE. VOLUME SERIAL NO=YYYYYY 

IEH8391 HIGHEST RETURN CODE ENCOUNTERED WAS 00 

Note: The serial number you indicate in the DADEV DD statement will appear 
instead of YYYYYY. 
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Loader Program Test Program 

In order to test the loader program, punch the Assembler sample program, IEIJESP, 
from SYS1.SAMPLIB following the procedure described in the section "System 
Generation Using the Starter Operating System." For detailed information about 
the sample program, see the writeup for "Assembler F Sample Program (IEOESP)." 

To test the sample program and the loader program, call the IBM-supplied 
cataloged procedure, ASMFCG, using the following JCL statements. 

//jobname JOB 

//step name EXEC ASMFCG 

//ASH. SYS IN DD * 

(sample program source deck) 
/* 

A more detailed explanation of the contents of the procedure is given in OS 
Assembler (F) Programmer's Guide. 

All IBM-supplied cataloged procedures use the ddnames SYSLIN, SYSLIB, and 
SYSLOUT for the loader program. If other ddnames are assigned by the 
installation at system generation time, then these alternate ddnames must be 
substituted in the ASMFCG cataloged procedure. 

OPERATING INSTRUCTIONS 

The operating instructions to be followed are those provided with the IEUESP 
sample program. 

OUTPUT 

The output will be the same as the output for the IEUESP sample program. The 
loader output, however, will be different from the linkage-editor output: 

1. No cross reference list is produced. 

2. The storage map contains the absolute addresses of the external names 
rather than the relative addresses. 
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PL/I F Sample Program (IEMSP2) 

The IEMSP2 card deck (punched froi SYS1.SAMPLIB) consists of: 

1. Job control language statements for a PL/I compilation, link-edit, and 
execution of the compiled program. The cataloged procedure PL1LFCLG is 
used. 

2. PL/I sample program source statements. 

3. Input data. 

The purpose of the sample program is to illustrate the use of record-oriented 
input/output, initialization of STATIC arrays, and tabulation of data-directed 
output. Statements used include PROCEDORE, DECLARE, BEGIN, END, ON, GOTO, 
READ, HRITE, POT EDIT, and POT DATA. 

OPERATING PROCEDORES 

1. Mount the operating system. 

2. Set the load address switches and press the Initial Program Load key to 
load the operating system. 

3. Place the IEMSP2 card deck in the card reader, ready the reader, and press 
the End-of-File key. 

4. Ready the printer. 

5. Execute the job. 

OOTPOT 

1. Job control language statements in the cataloged procedure. 

2. Normal compilation output: 

a. All source statements. 

b. An attribute and cross-reference listing. 

c. A list of errors found during the compilation. 

3. Normal link-edit step output. 

4. The correct generated output is shown in Figure 47. 

OOTPOT OF PL/I SAMPLE PROGRAM 

THIS CARD IGNORED BECAOSE TYPE IS NOT NOMERIC:=*S DELIBERATE DOD CARD 

TYPE(0)« 1 TYPE(1) = TYPE (2)= 4 TYPE (3) » TYPE (4) = 1 
TYPE (5)= TYPE (6)= 10 TYPE (7)= 1 TYPE (8) = 1 TYPE (9) = 0; 

END OF SAMPLE OOTPOT 
Figure 47. PL/I Generated Output 
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RPG Sample Program (RPGSMPL) 

The RPGSMPL card deck (punched froa SYS1.SAMPLIB) consists of: 

1. Job control language statements to call a cataloged procedure for a 
compilation, link-edit, and execution of the sample program. 

2. Forty- five report program generator source statements. 

3. Thirteen data cards for the program to process; no other input is necessary. 

The program processes the 13 data cards, which contain details of customer 
transactions, and prepares the report shown in Figure 48. A detailed 
description of the source program appears in OS RPG Language. 

OPERATING INSTRUCTIONS 

1. Hount the operating system and an initialized scratch pack. 

2. Set the load address switches and press the Initial Program Load key to 
load the operating system. 

3. Place the RPGSMPL card deck in the card reader, ready the reader, and press 
the End-of-File key. 

4. Ready the printer. 

5. Execute the job. 

OUTPUT 

Program output consists of a printed listing of the source program and the 
printed report shown in Figure 48. 
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ACCOUNTS RE 


C E I V 


ABLE R 


E G I S T 


E R 






CUSTOMER 




LOCATION 


INVOICE 


INVOICE 


DATE 




INVOICE 


NUMBER 


CUSTOMER NAME 


STATE 


CITY 


NUMBER 


NO. 


DAY 




AMOUNT 


10712 


AMALGAMATED CORP 


33 


61 


11603 


11 


10 


$ 

$ 


389.25 
389.25* 


11315 


BROWN WHOLESALE 


30 


231 


12324 


12 


28 


$ 


802.08 


11315 


BROWN WHOLESALE 


30 


231 


99588 


12 


14 


$ 

$ 


261.17 
1,063.25* 


11897 


FARM IMPLEMENTS 


47 


77 


10901 


10 


18 


$ 

$ 


27.63 
27.63* 


18530 


BLACK OIL 


16 


67 


11509 


11 


8 


$ 


592.95 


18530 


BLACK OIL 


16 


67 


12292 


12 


23 


$ 
$ 


950.97 
1,543.92* 


20716 


LEATHER BELT CO 


36 


471 


11511 


11 


8 


$ 


335.63 


20716 


LEATHER BELT CO 


36 


471 


12263 


12 


17 


$ 
$ 


121.75 
457.38* 


290 17 


GENERAL MFG CO 


6 


63 


11615 


11 


14 


$ 


440.12 


29017 


GENERAL MFG CO 


6 


63 


11676 


11 


23 


$ 
$ 


722.22 
1,162.34* 


29054 


A-B-C DIST CO 


25 


39 


9689 


9 


11 


$ 


645. 40 


29054 


A-B-C DIST CO 


25 


39 


11605 


11 


11 


$ 


271.69 


29054 


A-B-C DIST CO 


25 


39 


12234 


12 


14 


$ 
$ 
$ 


559.33 
1,476.42* 
6,120.19** 



Figure 48. RPG Sample Prograa Printed Report 
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Sample Account Routine (SAMACTRT) 

This sample account routine is intended for use as a model of an account 
routine. Listing the cards that have been punched out from SYS1.SAMPLIB 
provides sample coding that can be used for reference while the user is writing 
his own account routine. 
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Sort/ Merge Sample Program (IERSP) 

The IERSP card deck (punched from SIS1. SAMPLIB) consists of: 

1. Job control language statements for TAPESORT 

2. Job control language statements for DISKSORT 

3. Data to be sorted 

The data to be sorted consists of 500 80-character records, each containing 
a six-digit sequence number and a ten-character control field. As provided, 
the data deck is in the six-digit sequence number order. The SORT control 
card specifies that the data is to be sorted on the ten-character control 
field. The output of either a TAPESORT or a DISKSORT will be in ten-character 
control field sequence. 

The TAPESORT job control language statements provided in IERSP call for five 
tape units (three for scratch, one for SORTIN, and one for SORTOUT) . To use 
more than three work tapes, add additional cards behind the SORTWK03 DD card. 
They should be identical to other SORTWK DD cards except for DD names, which 
must be consecutive, that is, SORTWK04, SORTWK05, . . . , SORTWK32. SORTOUT is 
specified as a 9-track 800-BPI tape. 

The DISKSORT job control language statements provided in IERSP call for six 
work areas of 30 consecutive tracks each on a 2311. If the output from the 
DISKSORT is to be printed in a print step, the DISP parameters in the SORTOUT 
DD card must be changed to (,PASS) before the sort run. 

OPERATING INSTRUCTIONS 

1. Mount the operating system and an initialized scratch pack. 

2. Set the load address switches and press the Initial Program Load key to 
load the operating system. 

3. For a TAPESORT, the data deck should be placed on tape as one unblocked 
sequential data set. An operator message (during step #7) will give 
mounting instructions. 

For a DISKSORT, the data deck should be placed on the scratch pack (mounted 
in step #1) as one unblocked sequential data set and cataloged under the 
name TEST. 

ft. For a TAPESORT, place the TAPESORT job control language statements in the 
card reader followed by a /* card. 

For a DISKSORT, place the DISKSORT job control language statements in the 
card reader followed by a /* card. 

5. Ready the reader and press the End-of-File key. 

6. Ready the printer. 

7. Execute the job. 

OUTPUT 

A message to the operator will indicate the unit assigned to SORTOUT (unit 
containing output) . This output can be printed and reviewed. The records 
will be in 10-character control field sequence. 

Output of TAPESORT will be on tape. Output of DISKSORT will be on disk. 
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Update Analysis Program (IHGSAMP) 

The IHGSAMP card deck (punched from SYS1. SAMPLIB) consists of: 

1. Job control language statements and data to accomplish Stage I, steps 1, 
1A, 2, 3, 4, 5, 6, and 7 described in the "Output" section. 

2. Job control language statements to accomplish Stage II, steps 3, 4, 5, 
and 6. 

This sample problem is a two-stage operation reguiring two input card decks. 
The Stage I input deck is complete. However, the output created by Stage I 
must be placed in front of the Stage II input deck before Stage II can be 
executed. (The output of Stage I is the job control language statements to 
accomplish Stage II, steps 1 and 2.) 

To demonstrate the functions of Update Analysis, it is necessary to create 
some data sets on a disk pack of the operating system. However, the sample 
problem has been constructed so that at its completion all data sets created 
by it are deleted. Therefore, the program can be run without leaving residue 
from its operations on the system disk packs. The printer output acts as a 
graphic demonstration of the changing programs. 

Stage I builds two sample symbolic libraries and one sample change library. 
It then executes the Update Analysis Program, which creates the job stream 
reguired to update the sample libraries. Stage II utilizes the output of the 
Update Analysis to update the two sample libraries, then proceeds to eliminate 
the data sets from the system. This is described in "Output." 

OPERATING INSTRUCTIONS 

1. Mount the operating system and initialized scratch pack. 

2. Set the load address switches and press the Initial Program Load key to 
load the operating system. 

3. Place the Stage I card deck in the reader and ready the reader, printer, 
and punch. 

4. Execute the Stage I job stream. 

5. At the end of the job, take the output of Stage I from the punch stacker 
and place in front of Stage II deck. 

6. Place the Stage II deck in the reader and ready the reader. 

7. Issue commands: 
START RDB, 00C 

to execute the Stage II job stream. 

OUTPUT 

Stage I 

Step 1 EXEC IEBUPDTE 

This step creates a temporary data set that contains the SYSIN control 
cards for step 1A. 
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Step 1A EXEC IEBGENER 

This step creates^the PDS SAMPLCHG, which is the change PDS containing 
three change members to be applied to the two sample libraries. 

Step 2 EXEC IEBOPDTE 

This step creates the PDS SAMPLIB1, which is a sample system library 
containing two members: MEMBER1 and MEMBER2. 

Step 3 EXEC IEBOPDTE 

This step creates the PDS SAMPLIB2, which is a sample system library 
containing one member: MEMBER3. 

Step 4 EXEC IEHLIST 

This step lists the directories of the two sample libraries. The 
list shows the SSI bytes of the members prior to updating. 

Step 5 EXEC IHGDAP 

This step causes the SAHPLCHG PDS to be analyzed and creates the job 
stream that updates the sample system libraries. For the purpose 
of the sample problem, this output is temporarily stored on disk to 
be available for steps 6 and 7. 

Step 6 EXEC IEBPTPCH 

This prints the output of step 5. 

Step 7 EXEC IEBPTPCH 

This punches the output of step 5. 

Stage II 

Steps 1 (Using punched output from step 7 
and 2 of Stage I) 

EXEC IEBUPDTE Update SAMPLIB1 

EXEC IEBUPDTE Update SAMPLIB2 

Step 3 EXEC IEHLIST 

This step lists the directories of the two sample libraries. The 
list shows the SSI bytes of the members after they have been updated. 

Step 4 EXEC IEBUPDTE 

This reproduces SAMPLIB1 in its updated form and creates a printed 
list that shows the effect of the change. 

Step 5 EXEC IEBUPDTE 

This reproduces SAMPLIB2 in its updated form and creates a printed 
list that shows the effect of the change. 

Step 6 EXEC IEHPROGM 

SAMPLCHG, SAMPLIB1, and SAMPLIB2 data sets are deleted by means of 
job control language statements in step 5 of Stage I and step 5 of 
Stage II. As a check, however, step 6 attempts to delete the same 
data sets and generates the diagnostic message, "DATA SET OR MEMBER 
NOT FOUND." 
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User Label Sample Program (USERLABL) 

The USERLABL card deck (punched from SIS1 .SAMPLIB) consists of sample program 
source statements. 

The sample program demonstrates the user label and user totaling functions 
and serves as a minimal test of these functions. In addition, it provides 
sample coding that demonstrates how to code a routine to process user labels. 

The sample program creates a data set that contains eight user header labels, 
500 data records, and eight user trailer labels on a direct access or magnetic 
tape volume. It also maintains a record count as an example of the use of 
the totaling facility. A listing of the source program card deck provides 
you with a sample of the basic coding reguired as an interface between the 
control program and a user label routine. 

You must provide the job control language required to assemble, link-edit, 
and run the sample program. A suggested sequence of JCL to assemble using 
Assembler F is: 

//jobname JOB 

//stepname EXEC PROC=ASMFCLG 

//ASfl.SYSIN DD * 

. Sample Program Source Deck 

/* 

//GO. OUTPUT DD (parameters necessary for a volume output device) 

//GO.SYSPRINT DD (parameters necessary for your printer) 

You must prepare two DD statements for the GO step: one for the data set to 
be created and one for the messages written by the sample program. The first 
DD statement must have a ddname of OUTPUT and contain LABEL=(,SUL) plus the 
additional parameters required for the output device desired. The second DD 
statement must have a ddname of SYSPRINT and contain the additional parameters 
reguired for the system printer. 

OPERATING INSTRUCTIONS 

1. Hount the operating system and the desired direct-access device or magnetic 
tape volume. 

2. Set the load address switches and press the Initial Program Load key to 
load the operating system. 

3. Place the USERLABL card deck with the JCL in the card reader, ready the 
reader, and press the 'End-of-File key. 

4. Ready the printer. 

5. Execute the job. 

OUTPUT 

The following is written on the output device specified in the DD statement 
for the output device: 

1. Eight user header labels. 

2. A one-volume data set consisting of eight records. 

3. Eight user trailer labels. 

In order to verify the results of this sample program it is suggested that 
you print the contents of the data set and its tables. 
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Examples 



This section contains three examples of system generation. 

• Example 1 shows the generation of the 3330 starter operating system. It 
illustrates a complete system generation and a nucleus generation. 

• Example 2 shows a complete operating system generation and an I/O device 
generation using the starter operating system. 

• Example 3 shows a TSO generation. 

The machine configurations and operating systems shown in these examples are 
not meant to represent the needs of an average installation, but were chosen 
because of their value as examples. The numbers chosen for space allocation 
in these examples are for illustrative purposes only. Exact space requirements 
for the system data sets can be found in OS Storage Estimates. 
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Example 1 

This example shows the contents of the 3330 starter operating system. The 
example consists of: 

• A diagram of a machine configuration 

• A diagram of the volumes that contain generating and new system data sets 

• An input deck listing used for initializing new system data sets 

• A deck used for system generation 

In addition, sections describe the following: 

• Creating backup of the new system 

• Scratching utility data sets 

• Cataloging the generating SYS1.GENLIB, SYS1.MODGEN, SYS1.MODGEN2, and 
component libraries in the new system 

• Osing the new system to add a second nucleus to itself 

Volumes Used for System Generation 

Figure 49 shows the volumes that contain the generating and new system data 
sets. The serial number of the generating system-residence volume is 111111. 
Volume DLIB0 1 contains the remaining generating system data sets. The serial 
number of the new system-residence volume is SYSTEM. It is assumed that SYSTEM 
has been previously initialized. The five utility data sets used during system 
generation are named SYS1.0BJMOD, SYS1.0T10, SYS1.UT20, SYS1.UT30, and 
SYS1.0T40. 
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Figure 49. Example 1: Generating and New System Volumes 



Machine Configuration 



Figure 50 shows the machine configuration used in this example. 
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IBM SYSTEM / 360 MODEL 150 



J3 



1052-1 
KEYBOARD 



3t*£CT ACCESS 

""""PS) 



JjS 



Addresses 180 to 184 and 280 to 284 may be replaced with 3400 
series tape drives. If the 3400 series drives are to be used and 
2400 devices are not available, UNIT=2400 should be specified 
for the 3400 tape drives. 




Figure 50 (Part 1 of 2) . Example 1: 3330 Starter Machine Configuration 



Note : The I/O device configuration shown in the example is not necessarily valid 
for all CPUs. 
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DIRECT 
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Figure 50 (Part 2 of 2) . Example 1: 3330 Starter Machine Configuration 
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Deck for Initializing New System Data Sets 

Figure 51 shows a listing of the input deck used for initializing the new 
system data sets. During this initialization, the SYSTEM volume must be 
mounted. It is assumed that there is no dependency on device addresses and 
that the volume can be mounted on any 3330 drive. For illustrative purposes, 
assume that volume 111111, DLIB01, DLIB04, and SYSTEM are mounted on drives 
131, 350, and 351, respectively. 



//SYS GEN 

//STEPO 

//SYSPRINT 

//CATALOG 

// 

// 

//SVCLIB 

// 

// 

//NUCLEUS 

// 
// 

//JOBQE 

// 

//LINKLIB 

// 
// 

//PROCLIB 

// 
// 

//PARMLIB 

// 

// 

//IMAGELIB 



//SYSIN 

CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 



-EXAMPLE 1- 
-ALLOCATE ON 3330- 



JOB MSGLEVEL=1 
EXEC PGM=IEHPROGM 
DD SYSOUT=A 
DD DSNAME=SYSCTLG,VOLUME= (, RETAIN, SER=SYSTEM) , X 

UNIT=3330,DISP=(,KEEP) ,SPACE=(TRK, (10,1) ) , X 

LABEL=EXPDT= 99350 
DD DSNAME=SYS1. SVCLIB, VOLUME=(, RETAIN, SER=SYSTEM) , X 

UNIT=3330,DISP=(,KEEP) ,SPACE= (CYL, (4, 1,90) ) , X 

LABEL=EXPDT=99350, DCB= (DSORG=POU,RECFM=U,BLKSIZE= 1024) 



DD DSNAME=SYS1. NUCLEUS, VOLUME=(, RETAIN, SER=SYSTEM) , 

UNIT=3330,DISP=(,KEEP) ,SPACE= (TRK, (10, ,2) , ,CONTIG) , 
LABEL=EXPDT=99350 
DD DSNAME=SYS1. SYS JOBQE, VOLUME=(, RETAIN, SER=SYSTEM) , 

UNIT=3330,DISP=(,KEEP) ,SPACE=(TRK, (300) ,,CONTIG) 
DD DSNAME=SYS1. LINKLIB, VOLUME=(, RETAIN, SER=SYSTEM) , 
UNIT=3330,DISP=(,KEEP) ,SPACE=(CYL, (8,5,50)) , 
LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=3625) 
DD DSNAME=SYS1. PROCLIB, VOLUME=(, RETAIN, SER=SYSTEM) , 
UNIT=3330,DISP=(,KEEP) ,SPACE=(TRK, (15,6,9) , 
LABEL=EXPDT=99350,DCB=(RECFM=F,BLKSIZE=80) 
DD DSNAME=SYS1. PARMLIB, VOLUME=(, RETAIN, SER=SYSTEM) , 

UNIT=3330,DISP=(,KEEP) ,SPACE= (TRK, (5,, 1) ,,CONTIG) , 
LABEL=EXPDT=99350, DCB= (RECFM=F,BLKSIZE=80) 
DD DSNAME=SYS1. IMAGELIB, VOLUME= (, RETAIN, SER=SYSTEM) , 
UNIT=3330,DISP=(,KEEP) ,SPACE= (TRK, (2,, 3) ,,CONTIG) , 
LABEL=EXPDT=9935 0,DCB=(RECFM=U,BLKSIZE=1024) 
DD * -INPUT FOR CATALOGING SYSTEM DATA SETS- 

CVOL=3330=SYSTEM,VOL=3330=SYSTEM,DSNAME=SYS1. LINKLIB 
CVOL=3330=SYSTEM, VOL=3330=SYSTEM, DSNAME=SYS 1 . PROCLIB 
CVOL=3330=SYSTEM,VOL=3330=SYSTEM,DSNAME=SYS1. PARMLIB 
CVOL=3330 = SYSTEM,VOL=3330=SYSTEM,DSNAME=SYS 1. NUCLEUS 
CVOL=3330=SYSTEM,VOL=3330=SYSTEM,DSNAME=SYS1. JOBQE 
CVOL=3330=SYSTEM,VOL=3330=SYSTEM,DSNAME=SYS1.MACLIB 
CVOL=3330=SYSTEM/VOL=3330= SYSTEM, DSNAME=SYS1. IMAGELIB 
CVOL=3330=SYSTEM,VOL=3330=SYSTEM,DSNAME=SYS1. SVCLIB 



VOL=3330=DLIB01,DSNAME=SYS1.AS037 
VOL=333 0=DLIB0 1 , DSNAME=SYS 1 . DM509 
VOL=3330=DLIB01,DSNAME=SYS1.CI505 
VOL=3330=DLIB01,DSNAME=SYS1. DM508 
VOL=3330=DLIB01,DSNAME=SYS1.UT506 
VOL=333 0=DLIB01,DSNAME=SYS1.FO520 
VOL=3330=DLIB01,DSNAME=SYS1.LM501 
VOL=3330=DLIB01,DSNAME=SYS 1.10526 
VOL=3330=DLIB01,DSNAME=SYS1.ED521 



ASSEMBLER F 

BDAM 

CONTROL PROGRAM 

DATA MANAGEMENT 

UTILITIES 

FORTRAN G 

FORTRAN LIBRARY 

ISAM 

LINKAGE EDITOR F 



Figure 51 (Part 1 of 2) . Example 1: Initializing New System Data Sets 



126 OS System Generation 



CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 



VOL= 
VOL= 
VOL= 
VOL= 
VOL= 
VOL= 

VOL: 



=3330= 
=3330= 
=3330= 
= 3330= 
=3330= 
=3330= 
=3330= 



DLIB01 
DLIB01 
=DLIB01 
DLIB01 
DLIB01 
DLIB01 
=DLIB01 



,DSNAME= 
,DSNAME= 
,DSNAME= 
r DSNAME: 
,DSNAME= 
,DSNAME= 
DSNAME= 



=SYS1.LD547 
'SYS1.RG038 
SYS1.SM023 
=SYS1.PROCLIB 
SYS1. PARMLIB 
SYS1.MODGEN 
SYS1.GENLIB 



LOADER 

RPG 

SORT/MERGE 



/* 



Figure 51 (Part 2 of 2) . Example 1: Initializing New System Data Sets 

If the IBM-supplied copies of SYS1.PROCLIB and SYS 1. PARMLIB from DLIB0 1 are 
to be in the new system, they must be recataloged on the existing system. 
They are recataloged on the existing system to point to DLIB0 1. During system 
generation, SYS1.PROCLIB and SYS 1. PARMLIB are copied from the data sets 
cataloged on the generating system. 

Input Deck for Stage I 

Figure 52 shows a listing of the input deck used for system generation. The 
utility data sets are allocated space on the volumes indicated in Figure 49. 
The job stream will be written on an unlabeled magnetic tape that resides on 
drive 183 (see Figure 50) . Unit names are used. This input deck is the second 
step of the job illustrated in Figure 51. 

For Stage I of the system generation process, the volumes that are mounted 
are 111111, DLIB01, and SYSTEM. Stage II will be started automatically after 
Stage I is completed. 

The new system supports all the devices shown in Figure 50. The MFT control 
program is used. The compiler has all standard default options for compilation 
time. The procedure library and the unit names it requires are also included. 

//STEP1 EXEC PGM=ASMBLR -STAGE I INPUT- 

//SYSLIB DD DSNAME=SYS1.GENLIB,DISP=OLD 

//OBJPDS DD DSNAME=SYS1.0BJM0D,V0LUME=(,RETAIN,SER=111111) , X 

// DISP= (,CATLG) ,ONIT=3330,SPACE=(TRK, (30,20,8) ) 

//SYSOT10 DD DSNAME=SYS1. UT 10, VOLUME^ ( , RETAIN, SER=111111) , X 

// DISP=(, CATLG) ,UNIT=3330,SPACE=(TRK, (50, 10)) 

//SYSOT20 DD DSNAME=SYS1.UT20, VOLUME= (, RETAIN, SER=SYSTEM) , X 

// DISP= (, CATLG) ,UNIT=3330,SPACE=(TRK, (150, 10)) 

//SYSDT30 DD DSNAME=SYS1 .UT30 ,VOLDME= (, RETAIN, SER= 1 11 1 1 1) , X 

// DISP=(, CATLG) ,UNIT=3330,SPACE=(TRK, (150,10) ) 

//SYSUT40 DD DSNAME=SYS1.UT40,VOLUME= (, RETAIN, SER=SYSTEM) , X 

// DISP=(, CATLG) ,DNIT=3330,SPACE=(TRK, (5,10) ) 

//SYSPONCH DD UNIT=1 83, LABEL= (, NL) 

//SYSPRINT DD SYSODT=A 

//SYSIN DD * 

CENPROC CENPROCS INSTSET=UNIV,MODEL=50 

CONTRL CTRLPROG MAXIO=20,OVERLAY=BASIC,TYPE=MFT,SYSQUE=5000 

SUP SUPRVSOR OPTIONS==(TRSVCTBL,COMM) ,SER=SER0, X 

RESIDNT=ACSMETH 

SCHED SCHEDULR DESIGN=44K,CONSOLE=009, ALTCONS=01F, TYPE=MFT , X 

WTOBFRS=2,REPLY=2,JOBQLMT=960,OPTIONS=NOLOG 

PARTS PARTITNS P0 (C-D, S-8K) , P1 (C-ABC,S-65K) 

CHAN0 CHANNEL ADDRESS=0,TYPE=MULTIPLEXOR 

IOC0811 IOCONTRL UNIT=38 1 1 , ADDRESS=00 

IOD3211 IODEVICE UNIT=32 1 1 , ADDRESS=002 

IOC3811 IOCONTRL UNIT=381 1 , ADDRESS=00 

IOD3211 IODEVICE UNIT=321 1 , ADDRESS=004 

IQD10527 IODEVICE UNIT=1052, ADDRESS=009,MODEL=7 

Figure 52 (Part 1 of 3) . Example 1: Stage I Input Deck 
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IOC28215 IOCONTRL DNIT=2821 , ADDRESS=00, MODEL=5 

IOD1442N IODEVICE UNIT= 1442, ADDRESS=00A, MODEL=N 1 

IOD1443N IODEVICE UNIT=1443, ADDRESS=00B, MODEL=N1 

IOD2540R IODEVICE UNIT=2540R, ADDRESS=00C, MODEL=1 

IOD2540P IODEVICE ONIT=2540P, ADDF.ESS=00D,MODEL=1 

IOD14032 IODEVICE UNIT=1403, ADDRESS=00E, MODEL=2 

IOD14032 IODEVICE UNIT=1403, ADDRESS=00F, MODEL=2 

IOD3525P IODEVICE UNIT=3525, ADDRESS=0 13 

IOD3505R IODEVICE UNIT=3505, ADDRESS=0 12 

IOD10527 IODEVICE UNIT=1052, ADDRESS=0 1F, MODEL=7 

CHAN1 CHANNEL ADDRESS=1,TYPE= SELECTOR 

IOD2314 IODEVICE DNIT=23 14, ADDRESS= (130 , 6) 

IOD3330 IODEVICE UNIT=3330, ADDRESS= ( 150 ,4) 

IOC24034 IOCONTRL UNIT=2403, ADDRESS= 1 8,MODEL=4 

FEATURE=(DATACONV,7-TRACK,800BPI) 

IOD24014 IODEVICE DNIT=2401 , ADDRESS= ( 180, 2) ,MODEL=4, 

FEATURE=7-TRACK 

IOD24014 IODEVICE DNIT=240 1, ADDRESS= ( 1 82,3) ,MODEL=4, 

FEATORE= (9-TRACK, DUALDENS) 

IOC2841 IOCONTRL UNIT=2841 , ADDRESS=1 9 

IOD2311 IODEVICE UNIT=231 1 , ADDRESS= ( 190, 4) 

IOD2303 IODEVICE ONIT=2303, ADDRESS= 1 97 

IOC2820 IOCONTRL DNIT=2820, ADDRESS=1C 

IOD2301 IODEVICE UNIT=230 1 , ADDRESS= 1C0 

IOD23052 IODEVICE ONIT=2305, ADDRESS= 1D0,MODEL=2 

IOD23051 IODEVICE UNIT=2305, ADDRESS= 1F0, MODEL= 1 

CHAN2 CHANNEL ADDRESS=2, TYPE=SELECTOR 

IOD90527 IODEVICE UNIT=1052, ADDRESS=209, MODEL=7 

IOC28211 IOCONTRL ONIT=2821, ADDRESS=20,MODEL=1 

IOD1442 IODEVICE UNIT=1442, ADDRESS=20A, MODEL=N1 

IOD1443 IODEVICE 0NIT=1443, ADDRESS=20B,MODEL=N1 

IOD2540R IODEVICE DNIT=2540R, ADDRESS=20C, MODEL=1 

IOD2540P IODEVICE UNIT=2540P, ADDRESS=20D,MODEL=1 

IOD1443 IODEVICE 0NIT=1443, ADDRESS=20E, MODEL=2 

IOD10527 IODEVICE ONIT=1052, ADDRESS=2 1F,MODEL=7 

IOD2314 IODEVICE UNIT=23 14, ADDRESS= (230,6) 

IOD3330 IODEVICE UNIT=3330, ADDRESS= (250, 4) 

IOC24034 IOCONTRL UNIT=2403, ADDRESS=28,MODEL=4 , 

FEATURE=(DATACONV,7-TRACK,800BPI) 

IOD24014 IODEVICE DNIT=240 1,ADDRESS= (280,2) ,HODEL=4 r 

FEATURE=7-TRACK 

IOD24014 IODEVICE DNIT=2401 , ADDRESS= (282, 3) ,MODEL=4, 

FEATORE= (9-TRACK,DOALDENS) 

IOC2841 IOCONTRL ONIT-2841, ADDRESS=29 

IOD2311 IODEVICE ONIT=231 1 , ADDRESS= (290, 4) 

IOD2303 IODEVICE UNIT=2303, ADDRESS=297 

IOC2820 IOCONTRL ONIT=2820,ADDRESS=2C 

IOD2301 IODEVICE DNIT=230 1 , ADDRESS=2C0 

IOD23052 IODEVICE UNIT=2305, ADDRESS=2D0,MODEL=2 

IOD 23051 IODEVICE UNIT=2305, ADDRESS=2F0, MODEL= 1 

CHAN3 CHANNEL ADDRESS=3, TYPE=SELECTOR 

IOD 10527 IODEVICE DNIT=1052, ADDRESS=309,MODEL=7 

IOD2314 IODEVICE ONIT=2314, ADDRESS= (330,4) 

IOD3330 IODEVICE DNIT=3330,ADDRESS= (350, 4) 

SYSSQ UNITNAME NAME=SYSSQ, UNIT= ( ( 182, 4) , (282, 3) , ( 190, 4) , 

(290,4)) 



Figure 52 (Part 2 of 3) . Example 1: Stage I Input Deck 
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SYSDA 


UNITNAME 


SYSCP 


ONITNAME 


ASM 


ASSEMBLR 


EDIT 


EDITOR 


DTILS 


SYSUTILS 


UCS3211 


UCS 


IMGLIB 


IMAGELIB 


PARK 


PARMLIB 


PROC 


PROCLIB 


GEN 


GENERATE 



NAME=SYSDA,UNIT=( (190,4) , (290,4) , (130,6) 

(230,6) , (330,4) , (150,4) , (250,4) ,197,1C0, 

1D0,1F0,29 7,2C0,2D0,2F0, (350,4) ) 

NAME=SYSCP,ONIT=(00D,00A,20A,20D) 

DESIGN=F 

DESIGN=F44,SIZE=(100K,6K) 

SIZE=44K 

UNIT=2311,IMAGE=(A11,H11,G11,P11,T11) , 

DEFA0LT=(A1 1,P11) 



UT1SDS=SYSl.aT10,UT2SDS=SYS1,UT20, 
UT3SDS=SYSV.UT30,UT4SDS=SYS1.UT40, 
OBJPDS=SYS1.OBJHOD,RESTYPE=3330, 
RESNAME=3330,RESVOL=111111, 
LEPRT=(LIST,XREF) ,ASMPRT=ON, DIRDATA=PDS 



/* 
// 



END 
START 



RDR,183 



Figure 52 (Part 3 of 3) . Example 1: Stage I Input Deck 



Backup of New System 



Figure 53 shows a listing of the IEHDASDR input deck used for creating the 
backup of the new system. IEHDASDR operates under control of the generating 
system on 111111. The backup copy of SYSTEM is made on the SYS00 1 magnetic 
tape volume. After the backup copy has been made, SYS001 should be removed 
and stored in the tape library. 



//BACKUP 

// 

//SYSPRINT DD 
//SYSPACK DD 
//SYSTAPE DD 
//SYSIN DD 

DDMP 
/* 



JOB MSGLEVEL=1 
EXEC PGM-IEHDASDR 



-BACKUP- 



SYSOUT=A 

UNIT=3330,DISP=OLD,VOLUME=SER=SYSTEM 

DNIT=2400,DISP=OLD,VOLUME=SER=SYS001,LABEL=(,NL) 

* 

FROMDD=SYSPACK, TODD=SYSTAPE 



Figure 53. Example 1: Creating Backup of SYSTEM 
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Scratching Utility Data Sets 

After the new operating system is generated, SYS1.UT10, SYS1.UT20, SYS1.UT30, 
and SYS1.UT**0 should be scratched and uncataloged. The job stream and 
SYS1.0BJM0D should be saved. Figure 5H shows a listing of the input deck 
listing used for scratching and uncataloging the three sequential data sets. 
The magnetic tape volume that contains the job stream can be removed from unit 

183 and stored in the tape library. The BR14 program is executed under 

control of the generating system. 

//SCRATCH JOB MSGLEVEL=1 -SCRATCH DECK- 

//STEPO EXEC PGM=IEFBR14 

//SYSOT10 DD DSNAME=SYS1.UT10,DISP= (OLD, DELETE) 

//SYSOT20 DD DSNAME=SYS1 .OT20, DISP= (OLD, DELETE) 

//SYSOT30 DD DSNAME=SYS 1 .OT30, DISP= (OLD, DELETE) 

//SYSDT40 DD DSNAME=SYS 1 . OT40 , DISP= (OLD, DELETE) 



Figure 54. Example 1: Scratching Utility Data Sets 



Obtaining SYS1.6ENLIB, SYS1.M0DGEN, SYS1. M0DGEH2, and Component Libraries 

The new system (volume SYSTEM) meets all the requirements for a generating 
system except that it does not have SYS1.GENLIB, SYS1.MODGEN, SYS 1. MODGEN2, 
and the component libraries. These libraries can be copied from the generating 
system to the new system and then cataloged. Figure 55 shows a listing of 
the input deck used for cataloging SYS1.GENLIB and the component libraries 
in the new system. 



//SYSGEN JOB 


//STEP1 EXEC 


//SYSPRINT DD 


//PL1LIB DD 


// 


// 


//SYSIM DD 


CATLG 


CATLG 


CATLG 


CATLG 


CATLG 


CATLG 



/* 



MSGLEVEL=1 -PROCESSOR/LIBRARY GENERATION- 

PGM=IEHPROGM -ALLOCATE SYS1.PL1LIB- 

SYSOUT=A 

DSNAME=SYS1.PL1LIB,V0LUME= (, RETAIN, SER=SYSTEM) , 

UNIT=3330,DISP=(,KEEP) ,SPACE= (TRK, (80,10,65)) , 

LABEL=EXPDT=99350, DCB= (RECFM=U,BLKSIZE=3625) 

♦ 

VOL=3330=DLIB01,DSNAME=SYS1.PL1LIB 

DSNAME=SYS1.GENLIB,VOL=3330=DLIB01 

DSNAHE=SYS1.SODGEN,VOL=3330=DLIB01 

DSNAME=SYS1.HODGEN2,VOL=3330=DLIB01 

DSNAME=SYS1.NL511,VOL=3330*DLIB01 

DSNAME=SYS1.LI!512,VOL=3330=DL^B01 



Figure 55. Example 1: Cataloging SYS1.GENLIB, SYS1.MODGEN, SYS1 .MODGEN2, and 
Component Libraries 
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Nucleus Generation 



A second nucleus (02) is added to the new system during this generation. The 
same CENPROCS, CHANNEL, IOCONTRL, and IODEVICE macro instructions included 
in the generation of the new system (see Figure 52) must be included in this 
generation. The new nucleus will then support the same access methods as the 
first nucleus. Each nucleus must support the same control program (HFT) , 
because the resident portion of the control program (nucleus) must be compatible 
with the nonresident portion. 

Figure 56 shows the volumes involved in this generation. The five system 
generation utility data sets are named SYS1. OBJECT, SYS1.0NE, SYS1.TWO, 
SYS1. THREE, and SYS1.F00R. 




^j^ gj- SVCLIB 
f VS 1 MACLlB 
S *S 1 NUCLEUS 

^ Ti^ 10GREC^ ^> 
Sy S 1 FOUR 
£*? V USER 

f ^g t. LINKUP 
2 [S|. PROCLIB 
£^S t. PARMLlB 
£^ S t. SORTUB 
f ^S 1. FQRTLIB 
^ IS_V PL1LIB 
■V ^S 1, OBJECT 

v«^£ys 1 TWO 



_„ STARTER ,.. 
PIRATING SVS-f^ 



>S ys 1, MACLIB^ , 

<S VS 1 PROCUg 

■^S VS 1. MQDGg^ 
^ VS 1. MOOSE ** 

^S 1. PARML<B^ 
. ^S 1 TCAMW^ S»* 

* ^S 1.TSOMA-C ■ 

. ^S l.GENUB^ 
» ^S 1, SAMPUg ^ 
v £VS 1, TSOGEN^ . 

s£ OMp LIBRAW^ , 
^ YSl.ONE 
SYS 1. THREE 



Figure 56. Example 1: Volumes for Nucleus Generation 

Figure 57 shows a listing of the input deck used for this generation. STEP1 
catalogs the component libraries reguired. SYS1.GENLIB and SYS1.MODGEN are 
already cataloged in the system so only the component libraries reguired for 
this system generation need be added. STEP2 is the input deck for Stage 1. 
Five utility data sets are defined. Their names are SYS 1. ONE, SYS1.TWO, 
SYS1. THREE, SYS1.FOUR, and SYS1. OBJECT. The job stream will be written on 
an unlabeled magnetic tape that is located on drive 183. A user-written routine 
named NUCID2 is included in the nucleus. NUCID2 is a member of the SYS1.USER 
data set. 
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//SYSGEN 
//STEP1 
//NEWRES 
//SYSPRINT DD 
//SYSIN DD 

CATLG 

CATLG 

CATLG 

CATLG 

CATLG 
//STEP2 
//SYSLIB 
//OBJPDS 

// 

//SYS0T1 

// 

//SYS0T2 

// 

//SYSUT3 

// 

//SYSUT4 

// 

//SYSPUNCH DD 
//SYSPRINT DD 
//SYSIN DD 



JOB MCR,67,MSGLEVEL=1 -NUCLEUS GENERATION- 

EXEC PGM=IEHPROGM -COMPONENT LIBRARIES- 

DD UNIT=3330,VOLUME=SER=SYSTEM,DISP=OLD 
SYSOUT=A 

DSNAHE=SYS1.DSER,VOL=3330=SYSTEM 
DSNAME=SYS1.CI505,VOL=3330=DLIB01 
DSNAME=SYS1. DM509, VOL=3330=DLIB0 1 
DSNAME=SYS1. 10526, VOL=3330=DLIB01 
DSNAME=SYS1.PT516,VOL=3330=DLIB01 

EXEC PGM=ASMBLR -STAGE 1 INPUT- 

DD DSNAME=SYS1.GENLIB,DISP=0LD 

DSNAME=SYS1. OBJECT, VOLUME^ ( r RETAIN # SER=SYSTEM) , X 
DISP=(, CATLG) ,UNIT=3330 r SPACE=(TRK, (40,20,8)) 
DSNAME=SYS1. ONE, VOLUME=(, RETAIN, SER=DLIB01) , X 

DISP= (, CATLG) ,UNIT=3330,SPACE=(TRK, (30,20,8) ) 
DSNAME=SYS1.TWO,VOLUME=(, RETAIN, SER=SYSTEM) , X 

DISP=(, CATLG) ,UNIT=3330,SPACE=(TRK, (150,10)) 
DSNAME=SYS1. THREE, VOLUME= (, RETAIN, SER=DLIB01) , X 
DISP=(, CATLG) ,UNIT=3330,SPACE=(TRK, (150, 10)) 
DSNAME=SYS1. FOUR, VOLUME=(, RETAIN, SER=SYSTEM) , X 

DISP=(, CATLG) ,UNIT=3330,SPACE=(TRK, (5, 10) ) 
UNIT=183,LABEL=(,NL) 
SYSOUT=A 
* 

CENPROCS MODEL=50,INSTSET=UNTV 

CTRL PROG TYPE=MFT,MAXIO=20,OVERLAY=BASIC,SYSQUE=5000 

SCHEDULR CONSOLE=009,DESIGN=44K,ALTCONS=01F, X 

TYPE=MFT,JOBQLMT=960,OPTIONS=NOLOG 

SDPRVSOR RESIDNT=ACSMETH, X 

OPTIONS=(TRSVCTBL,COMM) , X 

TRACE=100,SER=SER0 X 

RESMODS PDS=SYS1.USER,MEMBERS=NUCID2 

GENERATE GENTYPE= (NUCLEUS ,2) ,UT1SDS=SYS 1. ONE, X 

UT2SDS=SYS1. TWO, UT3SDS=SYS1. THREE, UTUSDS=SYS1. FOUR, X 
OBJPDS=SYS1. OBJECT, RESNAME=3330,RESVOL=SYSTEM. X 
RESTYPE=3330, ASMPTR=ON, LEPRT= (LIST, XREF) 

END 



DD 



DD 



DD 



DD 



DD 



/* 
// 



START 



RDR, 183 



Figure 57. Example 1: Input Deck for Nucleus Generation 
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Example 2 

This example illustrates and describes: 

A machine configuration 

Deck listings used for initializing the starter operating system (2314 
distribution) 

Deck listings used for initializing direct-access volumes for the new 
system 

Volumes that contain generating and new system data sets 

A deck listing used for initializing new system data sets 

A deck listing used for system generation 

Deck listings used for system residence on 2303 

A deck listing used for I/O Device generation 

Machine Configuration 

Figure 58 shows the machine configuration used in this example. Only those 
devices in the shaded areas are supported by the starter operating system. 
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Figure 58 (Part 1 of 2) . Example 2: Machine Configuration 
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Figure 5 8 (Part 2 of 2) • Example 2: Machine Configuration 
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Decks Required to Dse the Starter Operating System 

Four steps are required for the starter operating system to be used as the 
generating system. The first step is to initialize the volumes that are to 
contain DLIB0 1 and DLIB02. The second step is to transfer the data from the 
distribution tapes to the volumes. The third step is to punch the programs 
desired from SYS1.SAMPLIB. The fourth step is to list the contents of 
SYS1.SAMPLIB, SYS1. NUCLEUS, and SYS 1 . PROCLIB. 

Figure 59 shows a listing of the input deck used for the first step. The 
IBCDASDI program is used to initialize the volumes that are to contain DLIB01 
and DLIB0 2. The serial numbers of the volumes are NNNNNN and XXXXXX. Both 
volumes are being initialized for the first time. The NNNNNN volume is located 
on unit 130 and the XXXXXX volume is located on unit 131. The DASDI deck is 
placed in the card reader located at address 00C. Messages will be printed 
on the printer located at address 00E. 



DLIB01 



DLIB02 



JOB 
MSG 
DADEF 

VLD 

VTOCD 

END 

JOB 

MSG 

DADEF 

VLD 

VTOCD 

END 



TODEV= 1U03, TOADDR=00E 

TODEV=2314,TOADDR=130,VOLID=SCRATCH, 
FLAGTEST=NO 
NEWVOLID=NNNNNN,OWNERID=DEPTD58 
STARTADR=50,EXTENT=10 



TODEV= 1403 , TOADDR=00E 

TODEV=2314,TOADDR=131,VOLID=SCRATCH, 
FLAGTEST=NO 
NEWVOLID=XXXXXX,OWNERID=DEPTD58 
STARTADR=50,EXTENT=10 



Figure 59. Example 2: Initializing Volumes for DLIB01 and DLIB02 

Figures 60 and 61 show the listings of the decks used for the second step. 
The IBCDMPRS program is used to transfer the data from the 2314 distribution 
tapes to the NNNNNN and XXXXXX volumes. The distribution tapes are located 
on units 282 and 283. The deck is placed in the card reader located at address 
00C, and messages are printed on the printer- located address 00E. 

Figure 60 shows the listings of the IBCDMPRS input deck used to transfer the 
first two files from the distribution tapes to volume NNNNNN. These two files 
contain the data for DLIB01. 



TAPE JOB 

MSG TODEV=1«»03,TOADDR=00E 

RESTORE FROMDEV=2400,FROMADDR=282,TODEV=2314, X 

TOADDR= 13 0, VOLID=NNNNNN 

END 
TAPE2 JOB 

MSG TODEV=1403,TOADDR=00E 

RESTORE FROMDEV=2400,FROMADDR=283,TODEV=2314, X 

TOADDR=130,VOLID=DLIB01 

END 

Figure 60. Example 2: Restoring DLIB01 

After executing the IBCDMPRS program, the volume on unit 130 is now DLIB01. 
Remove the tape on unit .282 and store it in the tape library as a backup for 
the starter system. Carry out the IPL procedure for the DLIB01 volume. The 
starter operating system on DLIB01 is used for the third and fourth steps. 
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Figure 61 shows a listing of the input deck used for the IEHDASDR program that 
transfers the data in the fourth file on the second tape of the distribution 
package to the XXXXXX volume to create DLIB02. 



//DLIB02 


JOB 


//REST 


EXEC 


//SYSPRINT 


DD 


//FROM 


DD 


// 




//DLIB02 


DD 


//SYSIN 


DD 



MSGLEVEL=1 

PGM=IEHDASDR, PARM= • N= 1 « 
SYSOUT=A 

UNIT=283,DISP=OLD,LABEL=(4,NL) , 
VOLUME=SER=REST02 

UNIT=131,DISP=OLD,VOLUME=SER=DLIB02 
* 

RESTORE FROMDD=FROM,TODD=DLIB02,CPYVOLID=YES, 
PURGE=YES 



Figure 61. Example 2: Restoring DLIB02 

Figure 62 shows a listing of the input deck used for the third step. The 
IEBPTPCH program is used to punch the desired contents of SYS 1. SAMPLIB. The 
independent utility programs, the sample programs for FORTRAN, PL/I, and 
Sort/Herge, and the IPL program are punched. 



//PUNCH JOB 


MSGLEVEL=1 -PUNCH SYS 1. SAMPLIB- 


// EXEC 


PGM=IEBPTPCH 


//SYS DTI DD 


DSNAME=SYS1. SAMPLIB, DISP= (OLD, KEEP) , 


// 


UNIT=2314,VOLUME=SER=DLIB02 


//SYS0T2 DD 


UNIT=2540-2 


//SYSPRINT DD 


SYSOUT=A 


//SYSIN DD 


♦ 


PUNCH 


TYP0RG=P0,MAXNAME=7 


MEMBER 


NAME=IBCDMPRS 


MEMBER 


NAME=IBCDASDI 


MEMBER 


NAME=IBCRCVRP 


MEMBER 


NAME=IEAIPL00 


MEMBER 


NAME=IEYSP 


MEMBER 


NAME=IEMSP2 


MEMBER 


NAME=IERSP 



/* 



Figure 62. Example 2: Punching Members of SYS1. SAMPLIB 

After these seven decks are punched, the first card (member name card) of each 
deck must be removed. 

Figure 63 shows a listing of the input deck used for the system data describing 
the starter system^ SYS 1. NUCLEUS, SYS1. SAMPLIB, and SYS 1. PROCLIB. 



//LIST JOB 
// EXEC 
//SYSPRINT DD 
//DD1 DD 
//DD2 DD 
//SYSIN DD 
LISTCTLG 
LISTVTOC 
LISTVTOC 
LISTPDS 
LISTPDS 
LISTPDS 
/* 



MSGLEVEL=1 

PGM=IEHLIST 

SYSOUT=A 

DISP=OLD,UNIT=2314,VOLUHE=SER=DLIB01 

DISP=OLD , UNIT=23 1 4 , VOLUME=SER=DLIB02 

♦ 

VOL-2314=DLIB01,DUMP 
VOL=2314=DLIB02,DUMP 

DSNAME=SYS1.NUCLEUS,VOL=2314=DLIB01 
DSNAME=SYS1.PROCLIB,VOL=2314=DLIB01 
DSNAME=SYS1. SAMPLIB, VOL=2314=DLIB02 



Figure 63. Example 2: Listing Data on DLIB01 and DLIB02 
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Initializing Volumes for New System 

The volumes for the new system must be initialized before system generation. 
Five volumes (besides DLIB01 and DLIB02) are used whose serial numbers are 
MVT111, MVT222, MVT333, MVT444, and MVT555. These volumes are mounted on units 
131, 230, 231, 232, and 132, respectively. MVT111 is to be the new system- 
residence volume. It is assumed that all these volumes have been previously 
initialized. 

Figure 64 shows five listings of the IBCDASDI input decks used for initializing 
the new volumes. The deck for MVT111 contains the IPL program (IEAIPL00) . 
The IPL cards were obtained from SYS1 . SAHPLIB (See Figure 62). 

The IBCDASDI object program cards must be placed in the card reader on unit 
00C and loaded into main storage. The input decks shown in Figure 61 are 
placed in the card reader immediately following the IBCDASDI object program 
deck. (For further details on the operating procedure for IBCDASDI, refer 
to OS Utilities.) 



MVT111 JOB 
MSG 
DADEF 
VLD 
VTOCD 
IPLTXT 



TODEV=1403,TOADDR=00E 

TODEV=2314,TOADDR=131,IPL=YES,VOLID=SCRATCH 
NEWVOLID=MVT1 1 1 , OWNERID=DEPTD58 
STRTADR=2,EXTENT=8 



IEAIPL00 cards 



END 

MVT222 JOB 
MSG 
DADEF 
VLD 
VTOCD 
END 

MVT333 JOB 
MSG 
DADEF 
VLD 
VTOCD 
END 

MVT444 JOB 
MSG 
DADEF 
VLD 
VTOCD 
END 

MVT555 JOB 
MSG 
DADEF 
VLD 
VTOCD 
END 



TODEV=1403,TOADDR=00E 
TODEV=2314,TOADDR=230,VOLID=SCRATCH 
NEWVOLID=MVT222, OWNERID=DEPTD58 
STRT ADP=2 , EXTENT=8 

TODEV= 1 403,TOADDR=00E 

TODEV=23 1 4,TOADDR=23 1 , VOLID=SCRATCH 

NEWVOLID=MVT333 , OWNERID=DEPTD58 

STRTADR=2,EXTENT=8 



TODEV=1 403 , TOADDR=00E 
TODEV=2314,TOADDR-232,VOLID=SCRATCH 
NEWVOLID=MVT444,OWNERID=DEPTD58 
STRT ADR=2 , EXTENT=8 



TODEV=1403,TOADDR=00E 
TODEV=2314,TOADDR=132,VOLID=SCRATCH 
NEWVOLID=MVT555,OHNERID=DEPTD58 
STRTADR=2,EXTENT=8 



Figure 64. Example 2: Initializing New System Volumes 
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volumes Dsed for System Generation 

Figure 65 shows the volumes that contain the generating and new system data 
sets. The serial number of the generating system-residence volume is DLIB01. 
The serial number of the new system-residence volume is MVT111. Volumes MVT222, 
MVT333, and MVT444 contain the remaining new system data sets. The five utility 
data sets used during system generation are named SYS1.SG0BJ, SYS 1. SGI, 
SYS1.SG2, SYS1.SG3, and SYS1.SG4. 




Figure 65. Example 2: Generating and New System Volumes (2314) 



Initializing New System Data Sets 

Figure 66 shows a listing of the input deck used for initializing the new 
system data sets. During this initialization, volumes DLIB01 f MVT111, MVT222, 
MVT333, and HVT444 must be mounted. The configuration used in this example 
(Figure 58) allows the simultaneous mounting of all seven volumes (Figure 65) 
involved in this generation. Therefore, to simplify operating procedures, 
all seven volumes should be mounted at this point. It is assumed that there 
is no dependency on device addresses, and. that the volumes can be mounted on 
any 23 14 drive. For illustrative purposes, assume that volumes DLIB01, MVT111, 
and MVT555 are mounted on drives 130, 131, and 132, and that volumes HVT222, 
MVT333, MVT444, and DLIB02 are mounted on drives 230, 231, 232, and 233, 
respectively. 
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-EXAMPLE 
-ALLOCATE ON 



2- 
2314- 



//SYSGEN JOB MSGLEVEL=1 
//STEP EXEC PGM=IEHPROGM 

//SYSPRINT DD SYSOOT=A 

//SVCLIB DD DSNAME=SYS1. SVCLIB, VOLUME= (, RETAIN, SER=MVT 1 1 1 ) , 

// UNIT=2314,DISP=(,KEEP) ,SPACE=(CYL, (7, 1,75)) , 

// LABEL=EXPDT=99350,DCB=(DSORG=POU,RECFM=U,BLKSIZE=1024) 

//CATALOG DD DSNAME=SYSCTLG, VOLUME= (, RETAIN, SER=MVT1 1 1) , 

// UNIT=2314,DISP=(,KEEP) , SPACE=(TRK, (6,1)) , 

// LABEL=EXPDT=99350 

//NUCLEUS DD DSNAME=SYS1 . NUCLEUS, VOLUME= (, RETAIN, SER=MVT1 1 1) , 

// UNIT=2314,DISP=(,KEEP) ,SPACE= (TRK, (20,, 1) ,,CONTIG) , 

// LABEL=EXPDT=99350 

//LINKLIB DD DSNAME=SYS 1 . LINKLIB, VOLUME= (, RETAIN, SER=MVT222) , 

// UNIT=2314,DISP=(,KEEP) ,SPACE= (CYL, (43,5,100) ) , 

// LABEL=EXPDT=99350,DCB= (RECFM=U,BLKSIZE=7294) 

//LOGX DD DSNAME=SYS1.SYSVLOGX,VOLUME= (, RETAIN, SER=MVT222) , 

// UNIT=2314,DISP=(,KEEP) ,SPACE=(120, (100) ,,CONTIG) , 

// LABEL=EXPDT=99350,DCB= (RECFM=VB,BLKSIZE=3625) 

//LOGY DD DSNAME=SYS1.SYSVL0GY,V0LUME= (, RETAIN, SER=MVT222) , 

// UNIT=2314,DISP=(,KEEP) ,SPACE= (120, (100) ,,CONTIG) , 

// LABEL=EXPDT=99350,DCB= (RECFM=VB,BLKSIZE=3625) 

//JOBQE DD DSNAME=SYS1.SYSJOBQE,VOLUME= (, RETAIN, SER=MVT333) , 

// UNIT=2314,DISP=(,KEEP) ,SPACE= (TRK, (200) ,,CONTIG) 

//PROCLIB DD DSNAME=SYS1.PR0CLIB,V0LUME= (, RETAIN, SER=MVT444) , 

// UNIT=2314,DISP=(,KEEP) ,SPACE= (TRK, (20,6,9) ) , 

// LABEL=EXPDT=99350,DCB=(RECFM=F,BLKSIZE=80) 

//PARMLIB DD DSNAME=SYS1 . PARMLIB, VOLUME= (, RETAIN, SER=MVT1 1 1) , 

// UNIT=2314,DISP=(,KEEP) ,SPACE=(TRK, (5,,1) ,,CONTIG) , 

// LABEL=EXPDT=99350,DCB=(RECFM=F,BLKSIZE=80) 

//MACLIB DD DSNAME=SYS1. MACLIB, VOLUME=(, RETAIN, SER=MVT444) , 

// UNIT=2314,DISP=(,KEEP) ,SPACE=(TRK, (300,30,25)) , 

// LABEL=EXPDT=99350,DCB= (RECFM=FB,BLKSIZE=7280, LRECL=80) 

//TELCLIB DD DSNAME=SYS 1 . TELCMLIB, VOLUME= (, RETAIN, SER=MVT444) , 

// UNIT=2314,DISP=(,KEEP) ,SPACE=(TRK, (30,2,10)) , 

// LABEL=EXPDT=99350,DCB= (RECFM=U,BLKSIZE-7294) 

//SORTLIB DD DSNAME=SYS 1 . SORTLIB, VOLUME= (, RETAIN, SER=MVT444) , 

// UNIT=2314,DISP=(,KEEP) ,SPACE=(TRK, (40,1,40)) , 

// LABEL=EXPDT=99350,DCB= (RECFM=U,BLKSIZE=7294) 

//PL1LIB DD DSNAME=SYS1. PL1LIB, VOLUME= (, RETAIN, SER=MVT444) , 

// UNIT=2314,DISP=(,KEEP) ,SPACE=(TRK, (55,2,65)) , 

// LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=7294) 

//FORTLIB DD DSNAME=SYS1 .FORTLIB, VOLUME= (, RETAIN, SER=MVT444) , 

// UNIT=2314,DISP=(,KEEP) ,SPACE=(TRK, (25,1,i40) ) , 

// LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=7294) 

//ALGLIB DD DSNAME=SYS1 . ALGLIB,VOLUME= (, RETAIN, SER=MVT444) , 

// UNIT= 2314, DISP=(, KEEP) ,SPACE=(TRK, (26,2,15)) , 

// LABEL=EXPDT=99350,DCB= (RECFH=U,BLKSIZE=7294) 

//SYSIN DD * -INPUT FOR CATALOGING SYSTEM DATA SETS- 

CATLG CVOL=2314=M7T11 1 , VOL=23 14=MVT222,DSNAME=SYS 1 . LINKLIB 

CATLG CV0L=2314=MVT1 1 1, VOL=2314=MVT1 1 1 ,DSNAME=SYS1 . SVCLIB 

CATLG CV0L=2314=MVT1 1 1 ,VOL=23 1 4=MVT333, DSNAME=SYS 1. SYS JOBQE 

CATLG CVOL=231 1=MVT1 1 1, V0L=2314=MVT444,DSNAME=SYS1 . PROCLIB 

CATLG CVOL=2314=MVT1 1 1 , VOL=23 14=MVT1 1 1 ,DSNAME=SYS 1 . PARMLIB 

CATLG CV0L=2314=MVT111,V0L=2314=MVT444,DSNAME=SYS1. MACLIB 

CATLG CVOL=2314=MVT111,VOL=2314=MVT444,DSNAME=SYS1. TELCMLIB 



Figure 66 (Part 1 of 2) . Example 2: Initializing New System Data Sets 
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CATLG CV0L=2314=MVT1 1 1 , VOL=2314=MVT444,DSNAME=SYS1 . SORTLIB 

CATLG CV0L=2314=MVT1 1 1 , VOL=23 14=MVT444, DSNAME=SYS 1. PL1LIB 

CATLG CVOL=23 1 4=MVT1 1 1 , VOL= 231 4=MVT444 , DSNAME=SYS1 . FORTLIB 

CATLG CV0L=2314 = MVT111,V0L=2314 = MVT444,DSNAME=SYS1. ALGLIB 

CATLG CVOL=23n=MVTl11,VOL=2314=MVT222,DSNAME=SYS1.SYSVLOGX 

CATLG CV0L=2314=MVT111,V0L=2314=MVT222,DSNAME=SYS1.SYSVL0GY 



/* 
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Input Deck for Stage I 

Figure 67 shows a listing of the input deck used for system generation. The 
utility data sets are allocated space on the volumes as indicated in Figure 
65. The job stream is written on an unlabeled magnetic tape that resides on 
drive 182 (See Figure 58) . Stage II will be started automatically after Stage 
I is completed. Unit names are used. 

The new system supports all devices shown in Figure 58. Multiprogramming with 
a variable number of tasks (MVT) is specified. All access methods and optional 
system data sets are generated. Assembler F, linkage-editor F44, Sort/Merge, 
ALGOL, FORTRAN G, PL/I F, and SPG are included in the new system. All standard 
default options are selected for the processors. 

After Stage II has terminated, SYS1.SG1, SYS1.SG2, SYS1.SG3, and SYS1.SG4 can 
be scratched and uncataloged. The job stream and SYS1.SG0BJ should be saved. 
DLIB01 and DLIB02 can be removed. A backup copy of the new system should be 
made. The new system is ready to operate after initial program load (IPL) . 



//STEP1 EXEC PGM=ASMBLR -STAGE I INPUT- 

//SYSLIB DD DSNAME=SYS1.GENLIB,DISP=0LD 

//OBJPDS DD DSNAME=SYS1.SG0BJ,V0LUME= (, RETAIN, SER=MVT555) , 
// DISP= (, CATLG) ,UNIT=2314,SPACE=(TRK, (45,5, 12)) 

//SYSDT1 DD DSNAME=SYS1. SG 1 , VOLUME= (, RETAIN, SER=MVT111) , 
// DISP=(, CATLG) ,UNIT=2314,SPACE=(TRK, (240,5)) 

//SYSDT2 DD DSNAME=SYS1. SG2, VOLOME= (, RETAIN, SER=MVT222) , 
// DISP=(, CATLG) ,UNIT=2314,SPACE=(TRK, (160, 10) ) 

//SYS0T3 DD DSNAME=SYS1.SG3,V0LUME= (, RETAIN, SER=MVT333) , 
// DISP=(, CATLG) ,DNIT=2314,SPACE=(TRK, (230,5)) 

//SYSUT4 DD DSNAME=SYS1. SG4 , VOLUME= (, RETAIN, SER=MVT333) , 
// DISP-(, CATLG) ,0NIT=2314,SPACE=(TRK, (3,3) ) 

//SYSPDNCH DD DNIT=1 82, LABEL= (, NL) 
//SYSPRINT DD SYSOUT=A 
//SYSIN DD * 

CE NPROCS MODEL=5 , FEATURE=PROTECT 
MPX CHANNEL ADDRESS=0 ,TYPE=MULTIPLEXOR 
CONSOLE IODEVICE UNIT=1052, MODEL=7, ADDRESS=009 
CNT00 IOCONTRL UNIT=282 1 ,MODEL=5, ADDRESS=00 ,FEATURE=COLBNRY, 

TRNMODE=BYTE 
DEV00C IODEVICE DNIT=2540R,KODEL= 1 , ADDRESS=00C 
DEV00D IODEVICE UNIT=2540P, MODEL=1 , ADDRESS=00D 
DEV00E IODEVICE UNIT=1403,MODEL=N1 , ADDRESS=00E 



Figure 67 (Part 1 of 4) . Example 2: Input Deck for Stage I 
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DEVOOF IODEVICE ONIT= 1403,MODEL=N 1 , ADDRESS=00F 

CNT01 IOCONTRL ONIT=282 1 , MODEL=5, ADDRESS=0 1 ,FEATURE=COLBNRY 

DEV01A IODEVICE UNIT=2540R, MODEL= 1 , ADDRESS=01 A 

DEV01B IODEVICE UNIT=254QP,MODEL= 1 , ADDRESS=0 IB 

DEV01F IODEVICE ONIT= 1 403,MODEL=N 1 , ADDRESS=01F 

CNT02 IOCONTRL UNIT=2702, ADDRESS=02 

LINE020 IODEVICE ONIT= 1030 , ADDRESS=020 , ADAPTER=IBM2, SETADDR=3 , X 

FEATURE=AUTOPOLL 
LINE021 IODEVICE UNIT= 1050 , ADDRESS=02 1 , ADAPTER=IBM1 ,SETADDR=1 , X 

FEATURE=AUTOPOLL 
LINE022 IODEVICE UNIT= 1050, ADDRESS=022, ADAPTER=IBM1 , SETADDR=1 , X 

FEATURE=AUTOPOLL 
LINE023 IODEVICE UNIT= 1060, ADDRESS=023 r ADAPTER=IBM1 ,SETADDR=1 , X 

FEATURE=AUTOPOLL 
LINE024 IODEVICE ONIT=83B3, ADDRESS=024,ADAPTER=TELE1 , SETADDR=3 
LINE025 IODEVICE UNIT-1 1 5A, ADDRESS=025 , ADAPTER=TELE1, SETADDR=3 
LINE026 IODEVICE UNIT=83B3, ADDRESS=026, ADAPTER=TELE1 ,SETADDR=3 
LINE027 IODEVICE UNIT= 1050 , ADDRESS=027 , ADAPTER=IBH 1 ,SETADDR= 1 , X 

FEATBRE=AUTOPOLL 
LINE028 IODEVICE DNIT= 1060, ADDRESS=028 , ADAPTER=IBM1,SETADDR=1 , X 

FEATURE= AUTO POLL 
LINE029 IODEVICE UNIT=1 15A,ADDRESS=029, ADAPTER=TELE1,SETADDR=3 
LINE02A IODEVICE UNIT=83B3, ADDRESS=02A,ADAPTER=TELE1 , SETADDR=3 
LINE02B IODEVICE UNIT= 1 060, ADDRESS=028 , ADAPTER=IBM 1,SETADDR= 1 , X 

FEATURE=AUTOPOLL 
LINE02C IODEVICE UNIT=1 15A,ADDRESS=02C, ADAPTER=TELE1,SETADDR=3 
LINE02D IODEVICE ONIT= 1030, ADDRESS=02D , ADAPTER=IBM2, SETADDR=2 , X 

FEATORE=ADTOPOLL 
LINE02E IODEVICE UNIT= 1030, ADDRESS=02E, ADAPTER=IBM2,SETADDR=2, X 

FEATORE=AOTOPOLL 
CH1 CHANNEL ADDRESS=1 ,TYPE=SELECTOR 
DEV130 IODEVICE UNIT=23 14 , ADDRESS= 130 
CNT18 IOCONTRL UNIT=2803,MODEL=1 , ADDRESS=18, X 

FEATDRE= (DATACONV,7-TRACK) 
DEV180 IODEVICE UNIT=2402,MODEL=3, ADDRESS^ (180,2) , X 

FEATURE=7-TRACK 
DEV182 IODEVICE ONIT=2402,MODEL=:3,ADDRESS= (182,2) , X 

FEATURE=9-TRACK 
CNT19 IOCONTRL UNIT=284 1 , ADDRESS=19 
DEV190 IODEVICE UNIT=2311 ,ADDRESS= (190 ,3) 
DEV193 IODEVICE UNIT=2303, ADDRESS=1 93 
CH2 CHANNEL ADDRESS=2,TYPE=SELECTOR 
DEV230 IODEVICE UNIT=2314, ADDRESS=230 
CNT28 IOCONTRL UNIT=2803 ,MODEL=1 , ADDRESS=28, X 

FEATORE= (DATACONV,7-TRACK) 
DEVX80 IODEVICE ONIT=2402,MODEL=3, ADDRESS=280,FEATURE=7-TRACK, X 

OPTCHAN=3 
DEVX81 IODEVICE UNIT=2402,MODEL=3, ADDRESS=281 ,FEATURE=7-TRACK X 

OPTCHAN=3 
DEVX82 IODEVICE UNIT=2402,MODEL=3, ADDRESS=282,FEATURE=9-TRACK, X 

OPTCHAN=3 
DEVX83 IODEVICE ONIT=2402,MODEL=3, ADDRESS=283,FEATURE=9-TRACK, X 

OPTCHAN=3 
DEVX84 IODEVICE UNIT=240 1 ,MODEL=3, ADDRESS-28a ,FEATURE=9-TRACK, X 

OPTCHAN=3 
DEVX85 IODEVICE UNIT=2401 ,MODEL=3, ADDRESS=285,FEATORE=9-TRACK, X 

OPTCHAN=3 

Figure 67 (Part 2 of 4) . Example 2: Input Deck for Stage I 
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DEVX86 IODEVICE UNIT=2401 , MODEL=3 , ADDRESS=286,FEATURE=9-TRACK, 

OPTCHAN=3 
DEVX87 IODEVICE UNIT=240 1 , MODEL=3, ADDRESS=287, FEATURE=9-TRACK, 

OPTCHAN=3 
CNT29 IOCONTRL UNIT=284 1 , ADDRESS=29 
CNT291 IODEVICE UNIT=231 1 , ADDRESS= (29 1 , 4) 

CNT2F IOCONTRL UNIT=2848, MODEL=3, ADDRESS=2F,FEATURE=NODESCUR 
DEV2F0 IODEVICE UNIT=2260 , MODEL= 1 , ADDRESS=2FO,FEATURE=ALKYB2260 
DEV2F1 IODEVICE UNIT=2260, MODEL= 1 , ADDRESS=2F 1 ,FEATURE=NMKYB2260 
DEV2F4 IODEVICE UNIT= 1 053, MODELS, ADDRESS=2F4 
CH3 CHANNEL ADDRESS=3,TYPE=SELECTOR 
CNT38 IOCONTRL UNIT=2803, MODEL= 1 , ADDRESS=38, 

FEATURE= (DATACONV,7-TRACK) 
CNT32 IOCONTRL UNIT=2841 , ADDRESS=32 
DEV320 IODEVICE UNIT=2302, MODEL=3 , ADDRESS=320 
DEV321 IODEVICE UNIT=2302, MODEL=3, ADDRESS=32 1 
CNT35 IOCONTRL UNIT=270 1 , ADDRESS=35 
DEV351 IODEVICE UNIT=2260, MODEL=1 , FEATURE=ALKYB2260,ADAPTER=IBM3, 

ADDRESS=351 
DEV355 IODEVICE DNIT=2260, MODEL= 1 , FEATURE=ALKYB226 0,ADAPTER=IBM3, 

ADDRESS=355 
CNT3A IOCONTRL UNIT=2840, MODEL=1, ADDRESS=3A 
DEV3A1 IODEVICE UNIT=2250, MODEL=2, ADDRESS=3A1 , NUMSECT=5, 

FEATURE=(ALKYB2250,LIGHTPEN,PRGMKYBD) 
DEV3A2 IODEVICE UNIT=2250 f MODEL=2, ADDRESS=3A2, NUMSECT=5, 

FEATURE= (ALKYB2250,LIGHTPEN, PRGMKYBD) 
DEV3E0 IODEVICE DNIT=2250 , MODEL= 1 , ADDRESS=3E0 , 

FEATURE=(ALKYB2250,BUFFER8K,LIGHTPEN,DESIGNFEAT) 
UNITNAME NAME=SYSSQ,UNIT=( (180,4) , (280,4) , (291,3)) 
UNITNAME NAME=SYSDA,UNIT=( (190,4) , (291,4) , (235,3)) 
UNITNAME NAME=SYSCP,UNIT=00D 
UNITNAME NAME=TAPE,UNIT= ( (282 ,6) ) 
UNITNAME NAME=RECORDS,UNIT= ((320,2)) 
UNITNAME NAME=FILE,UNIT=( (134,4) , (234,4) ) 
CTRLPROG TYPE=MVT,MAXIO=61,QSPACE=20,ADDTRAN=4 
SCHEDULR TYPE=MVT,CONSOLE=009,ALTCONS=(I-00D,O=00F) , 
STARTR=A-00D, STARTW=A-00E, 
ACCTRTN=BASIC,STARTI=AUTO,WTLBFRS=10, 
PROCRES=232,JOBQRES=231,INITQBF=10,MINPART=54 
SUPRVSOR RESIDNT=(BLDLTAB,RENTCODE,TRSVC) ,TRACE=100, 

OPTIONS= (PROTECT, COM M) ,TIMER=JOBSTEP, SER=SER1 
PROCLIB UNIT=2314,VOLNO=MVT444 
PARMLIB UNIT=2314,VOLNO=MVT111 
DATAMGT ACSMETH= (BDAM, ISAM,BTAM,QTAM) 
TELCMLIB UNIT=2314,VOLNO=MVT444 
GRAPHICS 

EDITOR DESIGN=F44 
ASSEMBLR DESIGN=F 

MACLIB UNIT=2314,VOLNO=MVT444,EXCLUDE= (OCR,TSO) 
CKPTREST ELIGBLE= (5,6,7,8) 
SORTMERG SIZE=24000, SORTOPT==FULLIB 
SORTLIB UNIT=2314,VOLNO=MVT444 

Figure 67 (Part 3 of 4) . Example 2: Input Deck for Stage I 
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ALGOL 

ALGLIB UNIT=2314,VOLNO=MVT444 

FORTRAN DESIGN=G 

FORTLIB DESIGN=G,UNIT=2314,VOLNO=MVT444 

PL1 DESIGN=F 

PL1LIB aNIT=2314,VOLNO=HVT444,LIBFCNS=COMPLEX 

GENERATE UT 1SDS=SYS 1. SG1 , UT2SDS=SYS1 . SG2, 0T3SDS=SYS1 . SG3, X 
OT4SDS=S YS 1 . SG4,OB JPDS=SYS 1 . SGOBJ, RESNAME=23 14, X 
RESV0L=MVT'1 1 1 , RESTYPE=231 4 ,LNKNAME=231 4 , 222 , X 

LNKVOL=MVT2 2 2 , ASMPRT=ON , X 

DIRDATA=PDS, LEPRT= (LIST,XREF) 

END 

/* 

// START RDR.P0,182 - This command is for MFT only - 
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Decks for System Residence on 2303 

The 2303 unit at address 197 (See Figure 58) can be used for system residence 
instead of volume MVT111. The IBCDASDI deck listing shown in Figure 68 replaces 
the deck listing for MVT111 shown in Figure 64. The serial number of the 2303 
volume is SYSRES. 

SYSRES JOB 

MSG TODEV-1403,TOADDR=00E 

DADEF TODEV=2303,TOADDR=197,IPL=YES,VOLID-SCRATCH 
VLD NEWVOLID=SYSRES, 0»NERID=DEPTD58 
VTOCD STRTADR=2,EXTENT=8 
IPLTXT 
■ 

IEAIPL00 cards 

END 

Figure 68. Example 2: IBCDASDI Deck for 2303 

The DD statements in Figure 69 must replace the DD statements for SYS1.SVCLIB, 
SYSCTLG, and SYS 1. NUCLEUS in Figure 66. The CATLG statements replace all the 
CATLG statements in Figure 66. 

Only two changes must be made to the Stage I input deck in Figure 67: 

• The SYS1.SG1 utility data set must be allocated space on SYSRES rather 
than on MVT111 as follows: 

//SYSOT1 DD DSNAME=SYS1.SG1,VOLUME= (, RETAIN, SER=SYSRES) , X 

// DISP=(, CATLG) ,ONIT=2303 r SPACB=(TRK, (180,16)) 

• The RESNAME, RESVOL, and RESTYPE parameters of the GENERATE macro 
instruction must be coded as follows: 

RESNAME=2303,RESVOL=SYSRES,RESTYPE=2303 
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//SVCLIB 

// 

// 

//CATALOG 

// 
// 

//NUCLEUS 

// 
// 



DD 



DD 



DD 



DSNAME=SYS1. SVCLIB, VOLUME^ (, RETAIN, SER=SYSRES) , X 

UNIT=2303,DISP=(,KEEP) ,SPACE=(TRK, (120,10,75)) , X 
LABEL=EXPDT=99350,D6B= (DSORG=POU r RECFM=U,BLKSIZE= 1024) 

DSNAHE=SYSCTLG,VOLUME=(, RETAIN, SER=SYSRES) , X 

UNIT=2303,DISP=(,KEEP) ,SPACE=(TRK, (8,1)) , X 
LABEL=EXPDT=99350 

DSNAHE=SYS1. NUCLEUS, VOLUME=(,RETAIN,SER-SYSRES) , X 

UNIT=2303,DISP=(,KEEP) ,SPACE=(TRK, (25, ,1) ,,CONTIG) , X 
LABEL=EXPDT=99350 



//SYSIN DD * -INPUT FOR CATALOGING SYSTEM DATA SETS- 

CATIG CVOL=2303=SYSRES,VOL=2314=MVT333,DSNAME=SYS1 . SYSJOBQE 

CATLG CVOL=2303=SYSRES,VOL=2314=WVT222,DSNAME=SYS1.LINKLIB 

CATLG CVOL=2303=SYSRES,VOL=2303=SYSRES,DSNAME=SYS1 . SVCLIB 

CATLG CVOL=2303=SYSRES,VOL=2314=MVT444,DSNAME=SYS1.PROCLIB 

CATLG CVOL=2303=SYSRES,VOL=2314=MVT444,DSNAME=SYS1 . PARMLIB 

CATLG CVOL=2303=SYSRES,VOL=2314=HVT444,DSNAME=SYS1.HACLIB 

CATLG CVOL=2303=SYSRES,VOL=2314=MVT444,DSNAME*SYS1.TELCMLIB 

CATLG CVOL=2303=SYSRES,VOL=2314=MVT444,DSNAME=SYS1.SORTLIB 

CATLG CVOL=2303=SYSRES,VOL=2314=:MVT444,DSNAME=SYS1.PL1LIB 

CATLG CVOL=2303=SYSRES,VOL=2314=MVT444,DSNAME=SYS1.FORTLIB 

CATLG CVOL=2303=SYSRES,VOL=2314=MVT444,DSNAME=SYS1 .ALGLIB 

CATLG CVOL=2303=SYSRES,VOL=2314=MVT222,DSNAME=SYS1.SYSVLOGX 

CATLG CVOL=2303=SYSRES,VOL=2314=MVT222,DSNAME=SYS1.SYSVLOGY 

/* 

Figure 69. Example 2: Allocation on 2303 

Input Deck for I/O Device Generation 

During I/O device generation, the arrangement of the communications terminals 
is changed, a 2803 and 2302 are deleted, and a 1052, 1403, 2314, 2841, and 
2321 are added to the system. The device, channel, and addresses are changed 
and new groups of devices are named. 

The CENPROCS, CTRLPROG, SUPRVSOR, DATAMGT, and GRAPHICS, macro instructions 
included in the complete operating system generation must be included in this 
generation. The CONSOLE and ALTCONS addresses are changed in the SCHEDULR 
macro instruction, but the STARTR, STARTW, PROCRES, and JOBQRES addresses 
cannot be changed until IPL time. The UNITNAHE macro instruction is used to 
rename and give new names to groups of devices. 

Figure 70 shows a listing of the input deck used for the I/O device generation. 
There is no allocation step before Stage I because there should be enough space 
available on the affected libraries, SYS1. NUCLEUS, SYS1.LINKLIB, SYS 1. SVCLIB, 
and SYS1.LOGREC. Because in an I/O device generation the system being modified 
cannot be the generating system, the starter operating system is used. DLIB01 
and DLIB02 must, therefore, be mounted before the generation starts. 

The job stream will be written on an unlabeled tape on drive 183. Stage II will 
be started automatically after Stage I is completed. SYS1.SG1 and SYS1.SG2 are 
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defined on volumes MVT111 and MVT222, respectively, whereas SYS1.SG3 and SYS1.SG4 
are defined on volume MVT333. A partitioned data set named SYS1.SG0BJ is 
allocated on volume MVT555. SYS1.SG1, SYS1.SG2, SYS1.SG3, and SYS1.SG4 will be 
deleted after they are no longer needed in Stage II. 



DD 
DD 
DD 



//SYSGEN 

//STEP1 

//SYSLIB 

//OBJPDS 

//SYSUT1 

// 

//SYSUT2 

// 

//SYSUT3 

// 

//SYS0T4 

// 

//SYSPUNCH DD 
//SYS PRINT DD 
//SYSIN 



JOB MSGLEVEL=1 
EXEC PGM=ASMBLR 



-I/O DEVICE GENERATION- 
-STAGE 1 INPUT- 



DD 



DD 



DD 



DSNAME=SYS1.GENLIB,DISP=0LD 

DSNAME=SYS1 . SGOBJ,DISP=OLD 

DSNAHE=SYS1.SG1,V0LUHE=(,RETAIN,SER=MVT111) , 

DISP=( r CATLG) ,0NIT=2314,SPACE=(TRK, (240,5) ) 

DSNAME=SYS1.SG2,VOLUME= (, RETAIN, SER=MVT222) , 

DISP= (,CATLG) ,ONIT=2314,SPACE=(TRK, (160,10) ) 

DSNAME=SYS1. SG3,VOL0ME= (, RETAIN, SER=MVT333) , 

DISP=(,CATLG) ,UNIT=2314,SPACE=(TRK, (280,5)) 

DSNAME=SYS1.SG4,V0LUME= (, RETAIN, SER=MVT333) , 

DISP=(,CATLG) ,UNIT=23m,SPACE=(TRK, (3,5)) 

TJNIT= 1 83 , LABEL= ( , NL) 

SYS00T=A 
DD * 

CENPROCS MODEL=50,FEATORE=PROTECT 
MPX CHANNEL ADDRESS=0,TYPE=MULTIPLEXOR 
CON00A IODEVICE UNIT=1052,MODEL=7, ADDRESS=00 A 
CON01A IODEVICE UNIT=1052,MODEL=7, ADDRESS=01 A 

CNT00 IOCONTRL UNIT=2821 ,MODEL-5, ADDRESS=00, FEATORE=COLBNRY 
DEV00C IODEVICE UNIT=2540R, MODEL=1 , ADDRESS=00C 
DEV00D IODEVICE UNIT=2540P, MODEL= 1 , ADDRESS=00D 
DEV00E IODEVICE ONIT=1403,MODEL=N1 , ADDRESS=00E 
DEV00F IODEVICE UNIT=1403,MODEL=N1 , ADDRESS=00F 
CNT01 IOCONTRL UNIT=2821, MODEL=5, ADDRESS=01 ,FEATURE=COLBNRY 
DEV01C IODEVICE UNIT=2540R, MODEL= 1 , ADDRESS=0 1C 
DEVOID IODEVICE UNIT=2540P, MODEL=1 , ADDRESS=0 1D 
DEV01E IODEVICE ONIT- 1403, M0DEL=N1 , ADDRESS=0 1E 
DEV01F IODEVICE ONIT=1403,MODEL=N1 , ADDRESS=01F 
CNT02 IOCONTRL ONIT=2702, ADDRESS=02 
LINE020 IODEVICE UNIT=1030, ADDRESS=020, ADAPTER=IB«2,SETADDR=3 , 

FEATURE=AUTOPOLL 
LINE021 IODEVICE UNIT=1050, ADDRESS=021,ADAPTER=IBM1 , SETADDR=1 , 

FEATURE^AUTOPOLL 
LINE022 IODEVICE ONIT=M060, ADDRESS=022,ADAPTER=IBM1 ,SETADDR=1 , 

FEATURE=AUTOPOLL 
LINE023 IODEVICE UNIT=1050, ADDRESS=023,ADAPTER=IBM1 , SETADDR=1 , 

FEATURE-AOTOPOLL 
LINE024 IODEVICE UNIT=1060, ADDRESS=024,ADAPTER=IBM1 ,SETADDR=1 , 

FEATDRE=AUTOPOLL 
LINE025 IODEVICE UNIT=1030, ADDRESS=025,ADAPTER=IBM2, SETADDR=3 , 

FEATURE=AUTOPOLL 
LINE026 IODEVICE ONIT= 1050, ADDRESS=026, ADAPTER=IBM1 ,SETADDR=1 , 

FEATURE=AOTOPOLL 
LINE027 IODEVICE UNIT=1060, ADDRESS=027,ADAPTER=IBM1 , SETADDR=1 , 

FEATURE=AUTOPOLL 
LINE028 IODEVICE UNIT=1050, ADDRESS=028,ADAPTER=IBM1 ,SETADDR=1 , 

FEATDRE=AOTOPOLL 
LINE029 IODEVICE UNIT=1050, ADDRESS=029,ADAPTER=IBM1 , SETADDR=1 , 

FEATURE=AUTOPOLL 
CH1 CHANNEL ADDRESS=1 r TYPE=SELECTOR 
DEV130 IODEVICE UNIT=2314,ADDRESS-130 
DEV140 IODEVICE ONIT=2314, ADDRESS=1 40 
CNT18 IOCONTRL UNIT*2803,MODEL=1 , ADDRESS^ 18 , 

FEATORE= (DATACONV,7-TRACK) 

Figure 70 (Part 1 of 3) . Example 2: Input for I/O Device Generation 
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DEV160 IODEVICE UNIT=2402,MODEL=3, ADDRESS= 180,FEATURE=7-TRACK 

DEV181 IODEVICE UNIT=2402, MODEL=3, ADDRESS= 18 1 ,FEATURE=7-TRACK 

DEV182 IODEVICE UNIT=2402,MODEL=3, ADDRESS^ 182 ,FEATURE=9-TRACK 

DEV183 IODEVICE UNIT=2402,MODEL=3, ADDRESS=1 83 ,FEATURE=9-TRACK 

CNT19 IOCONTRL UNIT=284 1 , ADDRESS= 19 

DEV190 IODEVICE 0NIT=231 1 , ADDRESS= ( 190, 3) 

DEV193 IODEVICE UNIT=2303 , ADDRESS= 193 

CNT1A IOCONTRL UNIT=284 1 , ADDRESS= 1 A 

DEV1A0 IODEVICE ONIT=232 1 ,MODEL= 1 , ADDRESS* 1 A0 

CH2 CHANNEL ADDRESS=2,TYPE=SELECTOR 

DEV230 IODEVICE UNIT=23 1 4 , ADDRESS=230 

CNT28 IOCONTRL DNIT=2803 r MODEL= 1, ADDRESS=28, X 

FEATORE= (DATACONV,7-TRACK) 
DEVX80 IODEVICE UNIT=2402, MODEL=3, ADDRESS= (280 , 2) , X 

FEATURE=7-TRACK, OPTCHAN=3 
DEVX82 IODEVICE UNIT=2402,MODEL=3, ADDRESS* (282,2) , X 

FEATURE=9-TRACK,OPTCHAN=3 
DEVX84 IODEVICE UNIT=240 1 , MODEL=3, ADDRESS= (284, 4) , X 

FEATURE=9-TRACK,OPTCHAN=3 
CNT29 IOCONTRL UNIT=284 1, ADDRESS=29 
DEV291 IODEVICE ONIT=23 1 1 , ADDRESS= (29 1 , 4) 

CNT2F IOCONTRL UNIT=2848,MODEL=3, ADDRESS=2F,FEATURE=NODESCUR 
DEV2F0 IODEVICE UNIT=2260,MODEL= 1 , ADDRESS=2F0 ,FEATURE=ALKYB2260 
DEV2F1 IODEVICE UNIT=2260, MODEL* 1,ADDRESS=2F1 ,FEATURE=NMKYB2260 
DEV2F4 IODEVICE UNIT*1053,MODEL=4 , ADDRESS=2F4 
CH3 CHANNEL ADDRESS=3,TYPE=SELECTOR 
CNT32 IOCONTRL UNIT=284 1 , ADDRESS=32 
DEV320 IODEVICE UNIT=231 1 , ADDRESS* (320,4) 
DEV324 IODEVICE UNIT=2302,MODEL=3, ADDRESS*324 
CNT35 IOCONTRL UNIT=270 1 , ADDRESS=35 
DEV351 IODEVICE UNIT=2260, MODEL* 1 ,FEATURE= ALKYB2260 , X 

ADAPTER=IBM3,ADDRESS=351 
DEV355 IODEVICE UNIT=2260,MODEL=1 ,FEATURE=ALKYB2260, X 

ADAPTER=IBM3,ADDRESS=355 
CNT3A IOCONTRL UNIT=2840 ,MODEL=1 , ADDRESS=3A 
DEV3A1 IODEVICE UNIT=2250 # HODEL=2, ADDRESS* (3A1 ,2) NUMSECT=5 , X 

FEATURE* (ALKYB2250,LIGHTPEN,PRGMKYBD) 
DEV3A3 IODEVICE UNIT*2250, MODEL* 1 , ADDRESS* (3 A3, 2) , X 

FEATORE=(ALKYB2250, BUFFER 8K,LIGHTPEN,DESIGNFEAT) 
UNITNAME NAME=SYSSQ, UNIT* ((180,4) , (280,4) ) 
ONITNAME NAME*SYSDA,UNIT=((190,4) ,(291,4)) 
UNITNAME NAME*SYSCP,UNIT*00D 
UNITNAME NAME=TAPE,UNIT=( (284,4)) 
UNITNAME NAME=DISK,UNIT= ( (320*4) ) 
UNITNAME NAHE=RECORDS,UNIT=324 
UNITNAME NAME=FILE,UNIT=1A0 
UNITNAME NAME*SYSCR,UNIT*00C 
UNITNAME NAME=PRINT,UNIT= ( (00E, 1) ) 
UNITNAME NAME*DATA, UNIT* (130, 140,230) 
CTRLPROG TYPE=MVT , MAXIO=6 1 , QS APCE=20 , ADDTRAN=4 
SCHEDULR TYPE=MVT,CONSOLE=(I=00A,O=01A) , X 

ALTCONS*(I-00D,O-00F,I-01D,O-01F) , X 

STARTR*A-00D,STARTW*A-00E, X 

ACCTRTN=BASIC,STARTI=AUTO,MINPART=54, X 

WTLBFRS=10,PROCRES=232,JOBQRES=231,INITQBF*10 
SUPRVSOR RESIDNT=(BLDLTAB,RENTCODE,TRSVC) ,TRACE=100, X 

OPTIONS= (PROTECT, COMM) , TIMER=JOBSTEP, SER-SER1 
DATAMGT ACSMETH* (BDAM,ISAM, BTAM, QTAM) 
GRAPHICS 

Figure 70 (Part 2 of 3). Example 2: Input for I/O Device Generation 
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GENERATE UT 1SDS=SYS1 . SG1 ,UT2SDS=SYS 1. SG2, UT3SDS=SYS 1. SG3, X 

TJT4SDS=SYS1.SG4,OBJPDS=SYS1.SGOBJ,GENTYPE=(IO,1) , X 

RESNAHE=2314,RESTYPE=2314,LNKNAME=23TU, X 

LNKVOL=MVT222,ASMPRT=ON,DIRDATA-PDS, X 
LEPRT=(LIST,XREF) ,RESV0L=M?T1 1 1 



END 

/* 

// START RDR, 183 



Figure 70 (Part 3 of 3). Example 2: Input for I/O Device Generation 
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Example 3 



This example illustrates and describes: 

Volumes that contain generating and new system data sets 
A deck listing used for initializing new system data sets 
A deck listing used for system generation 
A method for creating backup of a new system 
A method for scratching utility data sets 



Volumes Used for System Generation 

Figure 71 shows the volumes that contain the generating and new system data 
sets. The serial number of the generating system-residence volume is 111111. 
Volumes DLIB01, DLIB02, DLIB03, DLIB04, DLIB05 r and DLIB06 contain the remaining 
generating system data sets. The serial number of the new system-residence 
volume is SYSTEM. It is assumed that SYSTEM has been previously initialized. 
The five utility data sets used during system generation are named SYS1. OBJECT, 
SYS1.0NE, SYS1.TW0, SYS1. THREE, and SYS1.F00R. The SYS1.USER data sets contain 
user-written routines for the new system. 




mm 

s -~-S* gj. SVCUB > 

v^VSj. LINKUB^ 

^g* gCTLG _ 

*^£* SJ. PROCU g. 

£^g j. PARMU g, 

j^ Sj.SORTU B^ 

■ySV S 1. FORTU B, 

£*> _1. NUCLE US 

^£^S_1_L0GREC^^ 

^£Vs_TFOUR 




sy S 1.MODG6N 



^£VSj_GENL>B_ 
4^1. TCAWlM^E, 
^ S I.ONE 
SVS 1. MACL1B 




Figure 71. Example 3; Generating and New System Volumes 
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Deck for Initializing New System Data Sets 

Figure 72 shows a listing of the input deck used for initializing the new 
system data sets. During this initialization, volumes 111111, SYSTEM, and 
LINVOL must be mounted. It is assumed that there is no dependency on device 
addresses, and that the volumes can be mounted on any 2311 drive. For 
illustrative purposes, assume that volumes 111111, DLIB01, DLIB03, DLIB04, 
SYSTEM, and LINVOL are mounted on drives 161, 162, 163, 251,252, and 253, 
respectively. 



//SYSGEN 


JOB 


//STEPO 


EXEC 


//SYSPRINT 


DD 


//CATALOG 


DD 


// 




// 




//SVCLIB 


DD 


// 




// 




//MACLIB 


DD 


// 




// 




//NUCLEUS 


DD 


// 




// 




//JOBQE 


DD 


// 




//LIHKLIB 


DD 


// 




// 




//PROCLIB 


DD 


// 




// 




//PARMLIB 


DD 


// 




// 




//SORTLIB 


DD 


// 




// 




//FORTLIB 


DD 


// 




// 




//IMAGELIB 


DD 


// 




// 




//HELP 


DD 


// 




// 




//UADS 


DD 


// 




// 




//CMDLIB 


DD 


// 




// 




//BRODCAST 


DD 


// 




// 




// 




//SYS IN 


DD 


UNCATLG 


UNCATLG 


UNCATLG 


UNCATLG 



-EXAMPLE 3- 
-ALLOCATE ON 2311- 



MSGLEVEL=1 

PGM=IEHPROGM 

SYSOUT=A 

DSNAME=SYSCTLG,VOLUME= (RETAIN, SER = SYSTEM) , 

UNIT=2311,DISP=(,KEEP) ,SPACE= (TRK, = 10 , 1) ) , 

LABEL=EXPDT-99350 

DSNAME=SYS1. SVCLIB, VOLUME=(, RETAIN, SER=SYSTEM) , 

UNIT=231 1 ,DISP=(,KEEP) ,SPACE= (CYL, (15, 1,75) ) , 

LABEL=EXPDT=99350,DCB=(DSORG=POU,RECFM=U,BLKSIZE=102U) 

DSNAME=SYS1.MACLIB,V0LUME=(,RETAIN,SER=SYSTEM) , 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (440,50,25)) , 

LABEL=EXPDT=99350,DCB=(RECFM=FB,BLKSIZE=3360,LRECL=80) 

DSNAME=SYS 1 . NUCLEUS ,VOLUME= (, RETAIN, SER=SYSTEM) , 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (60, ,2) ,,CONTIG) 

LABEL=EXPDT=99350 

DSNAME=SYS1.SYSJOBQE,VOLUME= (, RETAIN, SER=LINVOL) , 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (120) ,,CONTIG) 

DSNAME=SYS1.LINKLIB,VOLUME= (, RETAIN, SER=LINVOL) , 

UNIT=2311,DISP=(,KEEP) ,SPACE=(CYL, (10 , 10, 100) ) , 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=3625) 

DSNAME=SYS1 . PROCLIB, VOLUME= (, RETAIN, SER=LINVOL) , 

UNIT=231 1 ,DISP=(,KEEP) ,SPACE= (TRK, (30, 10,9) , 

LA3EL=EXPDT=99350,DCB=(RECFM=F,BLKSIZE=80) 

DSNAME=SYS1. PARMLIB, VOLUME=(, RETAIN, SER=LINVOL) , 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (5,,1) ,,CONTIG) , 

LABEL=EXPDT=99350,DCB=(RECFM=F,BLKSIZE=80) 

DSNAME=SYS1 .SORTLIB, VOLUME= (, RETAIN, SER=LINVOL) , 

UNIT=2311,DISP=(,KEEP) , SPACE= (TRK, =60, 2, 40) ) , 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=3625) 

DSNAME=SYS1. FORTLIB, VOLUME= (, RETAIN, SER=LINVOL) , 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (50,2,40)) , 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=3625) 

DSNAME=SYS1. IMAGELIB, VOLUME=(, RETAIN, SER=LINVOL) , 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (5,, 3) ,,CONTIG) , 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=1024 

DSNAME=S YS 1 . HELP, VOLUME= ( , RETAIN , SER^LINVOL) , 

UNIT= 231 1,DISP=(, KEEP) ,SPACE=(TRK, (35,2,30)) , 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=800) 

DSNAME=SYS1 .UADS, VOLUME= (,RETAIN,SER= LINVOL) , 

UNIT=231 1,DISP=(,KEEP) , SPACE= (TRK, (35,2,30) ) , 

LABEL=EXPDT=99350,DCB=(DSORG=PO,LRECL=80,RECFM=FB) 

DSNAME=SYS1. CMDLIB, VOLUME= (,RETAIN,SER=LINVOL) , 

UNIT=2311,DISP=(,KEEP) ,SPACE=(TRK, (35,2,30)) , 

LABEL=EXPDT=99350 f DCB=(RECFM=U / BLKSIZE=3625) 

DSNAME=SYS1 .BRODCAST, 

VOLUME= ( , RETAIN , SER=LINVOL) , 

UNIT=2 311, DISP= ( , KEEP ) , 

DCB=DSORG=DA 

* -INPUT FOR CATALOGING SYSTEM DATA SETS 

D S NA ME= S Y S 1 . PROCLI B 

DSNAME=SYS1. PARMLIB 

DSNAME=SYS1. SORTLIB 

DSNAME=SYS1 .FORTLIB 



Figure 72 (Part 1 of 2) . Example 3: Initializing New System Data Sets 
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/* 



CATLG CVOL=2311 = SYSTEM,VOL=*2311 = 

CATLG CVOL=2311=SYSTEM,VOL=2311= 

CATLG CVOL=2311=SYSTEM,VOL=2311= 

CATLG CVOL=2311=SYSTEM,VOL=2311= 

CATLG CVOL=2311=SYSTEM,VOL=2311= 

CATLG CVOL=2311=SYSTEM,VOL=2311= 

CATLG CVOL=2311=SYSTEM,VOL=2311= 

CATLG CVOL=2311=SYSTEM,VOL=2311= 

CATLG CVOL=2311=SYSTEM,VOL=2311= 

CATLG CVOL=2311=SYSTEM,VOL=2311= 

CATLG CVOL=2311=SYSTEM.VOL=2311= 

CATLG CVOL=2 31 1=SYSTEM,VOL=231 1= 

CATLG VOL=2311=DLIB05,DSNAME=SYS 

CATLG VOL=2311=DLIB03,DSNAME=SYS 

CATLG VOL=2311=DLIB03,DSNAME=SYS 

CATLG VOL=2311=DLIB03,DSNAME=SYS 

CATLG VOL=231 1=DLIB03, DSNAME=SYS 

CATLG V0L=231 1=DLIB05,DSNAME=SYS 

CATLG VOL=2311=DLIB05,DSNAME=SYS 

CATLG VOL=2311=DLIB03,DSNAME=SYS 

CATLG VOL=2311=DLIB05,DSNAME=SYS 

CATLG VOL=2311=DLIB05,DSNAME=SYS 

CATLG VOL=2311=DLIB05,DSNAME=SYS 

CATLG VOL=2311=DLIB05,DSNAME=SYS 

CATLG VOL=2311=DLIB03,DSNAME=SYS 

CATLG VOL=2311=DLIB06,DSNAME=SYS 

CATLG VOL=2311=DLIB06,DSNAME=SYS 

CATLG VOL=2311=DLIB06,DSNAME=SYS 

CATLG VOL=2311=DLIB06,DSNAME=SYS 

CATLG VOL=2311=DLIB01,DSNAME=SYS 

CATLG VOL=2311=DLIB01,DSNAME=SYS 

CATLG VOL=2311=DLIB05,DSNAME=SYS 

CATLG VOL=2311=DLIB05,DSNAME=SYS 



LINVOL, DSNAME=SYS 1 . LINKLIB 
LINV0L,DSNAME=SYS1.PR0CLIB 
LINV0L,DSNAME=SYS1.PARMLIB 
SYSTEM, DSNAME=SYS1 . MACLIB 
LINVOL, DSNAME=SYS 1.S0RTLIB 
LINVOL, DSNAME=SYS1 .FORTLIB 
SYSTEM,DSNAHE=SYS1.SVCLIB 
LINVOL,DSNAME=SYS1 .HELP 
LINVOL,DSNAME=SYS 1. IMAGELIB 
LINVOL # DSNAME=SYS1.0ADS 
LINVOL,DSNAME=SYS 1.CMDLTR 
LINVOL , DSNAME=SYS 1 . BRODCAST 



1.AS037 

1. DM509 

1.CI505 

1. DM508 

1.OT506 

1.FO520 

1.LM501 

1.10526 

1.ED521 

1.LD547 

1.RG038 

1.SM023 

1.CQ548 

1.CI555 

1.DHELP 

1.DCMDLIB 

1.DUADS 

1 . PROCLIB 

1.PARMLIB 

1.SORTLIB 

1. FORTLIB 



ASSEMBLER F 

BDAM 

CONTROL PROGRAM 

DATA MANAGEMENT 

UTILITIES 

FORTRAN G 

FORTRAN LIBRARY 

ISAM 

LINKAGE EDITOR F 

LOADER 

RPG 

SORT/MERGE 

TCAM 

TSO 

TSO 

TSO 

TSO 



Figure 72 (Part 2 of 2) . Example 3: Initializing New System Data Sets 

Input Deck for Stage I 

Figure 73 shows a listing of the input deck used for system generation. The 
utility data sets are allocated space on the volumes indicated in Figure 71. 
The lob stream will be written on an unlabeled magnetic tape that resides on 
drive 190. Unit names are used. This input deck is the second step of the 
job defined in Figure 72. 

For Stage I of the system generation process the volumes that are mounted are: 
111111, DLIB01, DLIB02, DLIB04, SYSTEM, and LINVOL. Stage II will be started 
automatically after Stage I is completed. When it is required, the scheduler 
will request the demounting of DLIB02 and the mounting of DLIB06, the demounting 
of DLIB06 and the mounting of DLIB03, and the demounting of DLIB0 3 and the 
mounting of DLIB05. 

BDAM, BISAM, QISAM, TCAM, Assembler F, FORTRAN G, HELP, UADS, Sort/Merge, and 
RPG are included in the new system. The compilers have all standard default 
options for compilation time. The procedure library and the unit names it 
requires are also included. A user-written routine named NUCID is included 
in the nucleus. NUCID is a member of the SYS1.USER data set. 
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//STEP1 EXEC 

//SYSLIB DD 

//OBJPDS DD 

// 

//SYSOT1 DD 

// 

//SYSUT2 DD 

// 

//SYSOT3 DD 

// 

//SYSUT4 DD 

// 

//SYSPUNCH DD 

//SYSPRINT DD 

//SYSIN DD 

CENPROCS 



CHANO 

CONSOLE 

CONT00 

READOOA 

PUNCHOOB IODEVICE 

PRINTOOC IODEVICE 

PRINTOOD IODEVICE 

CONT0 1 

PRINTOOF 

CHAN1 

CONT16 

DISK161 

CO NT 19 

TAPE190 

TAPE191 

CHAN2 

CONT25 

DISK251 



PGM=ASMBLR -STAGE I INPUT- 

DSNAME=SYS1 .GENLIB, DISP=OLD 

DSNAME=SYS1. MOD, VOLUME=(# RETAIN, SER=SYSTEM) , 

DISP=(,CATLG) ,UNIT=2311,SPACE=(TRK, (60,10,12)) 

DSNAME=SYS1.0NE,V0LUME= (, RETAIN, SER=DLIB04) , 

DISP=(,CATLG) ,UNIT=2311,SPACE=(TRK, (350,10)) 

DSNAME=SYS1.TW0,V0LUME=(, RETAIN, SER=DLIB0 2) , 

DISP=(,CATLG) ,UNIT=2311,SPACE=(TRK, (240,20)) 

DSNAHE-SYS1. THREE, VOLUME= (, RETAIN, SER=SYSTEM) , 

DISP= (,CATLG) ,ONIT=2311,SPACE=(TRK, (400, 10)) 

DSNAME=SYS1.F0UR,V0LUME= (RETAIN, SER=111 111) , 

DISP=(,CATLG) ,UNIT=231 1 ,SPACE=(TRK, (5, 10) ) 

UNIT=190,LABEL=(,NL) 

SYSOUT=A 

* 

MODEL=65, 
CHANNEL ADDRESS=0 ,TYPE=HULTIPLEXOR 
IODEVICE UNIT=1052,MODEL=7,ADDRESS=010 
IOCONTRL UNIT=2821,MODEL=5,ADDRESS=00 
IODEVICE UNIT=2540R,MODEL=1,ADDRESS=00A 

UNIT=2540P,MODEL=1,ADDRESS=00B 

UNIT=1403,MODEL=3,ADDRESS=00C,FEATURE=UNVCHSET 

UNIT=1403,MODEL=3,ADDRESS=00D,FEATURE=UNVCHSET 
IOCONTRL DNIT=3811,ADDRESS=00 
IODEVICE UNIT=3211,ADDRESS=00F 
CHANNEL ADDRESS=1,TYPE=SELECTOR 
IOCONTRL UNIT=2841,ADDRESS=16 
IODEVICE UNIT=2311,ADDRESS= (16 1,3) 
IOCONTRL UNIT=2403,MODEL=3,ADDRESS=19 

IODEVICE UNIT=2403,MODEL=3,ADDRESS=190,FEATURE=9-TRACK 
IODEVICE UNIT=2401,MODEL=3,ADDRESS=(191,3) , 
FEATURE=9-TRACK 



CHANNEL 

IOCONTRL 

IODEVICE 

UNITNAME 

UNITNAME 

DNITNAME 

UNITNAME 

CTRLPROG 

SCHEDULR 

SUPRVSOR 



IMAGELIB 

UCS 

UCS 

PARMLIB 

PROCLIB 

RES MODS 

DATAMGT 

EDITOR 

LOADER 

ASSEMBLR 

MACLIB 



ADDRESS=2, TYPE=SELECTOR 

UNIT=284 1 , ADDRESS=25 

UNIT-231 1,ADDRESS= (251,3) 

N&ME=SYSSQ,UNIT=( (161,3) , (190,4) ,253) 

NAME=SYSDA,UNIT=( (161,3) ,253) 

NAME=SYSCP,UNIT=OOB 

NAME-TAPE, UNIT= ( ( 190 , 4) ) 

TYPE=MVT,HAXIO=30 

CONSOLE=010,STARTR=A-00C,STARTH=A-00C, 

TYPE=MVT,OPTIONS= (TSO) , JOBQRES=253, SUBMITQ=500 

RESIDNT=(TRSVC,ACSMETH) , 

OPTIONS= (PROTECT, TRSVCTBL) , 

WAIT= MULTIPLE, TIMER=JOBSTEP,SER=MCH 

UNIT=2311,VOLNO=LINVOL 

UNIT=3211,IMAGE=(A11,H11,P1 1) ,DEFAULT=A1 1, P1 1 

UNIT=1403,IMAGE=(AN r PN,TN) ,DEFAULT= (AN,PN) 

UNIT=231 1 ,VOLNO=LINVOL 

UNIT=2311,VOLNO=LINVOL 

PDS=SYS1.USER,MEMBERS=NUCID 

ACSMETH= (BDAM, ISAM, TCAM) 

DESIGN=F44 

SIZE=50K,PARM=MAP 

DESIGN=F 

EXCLUDE= (TRAM, QTAM, GPS, OCR) 



Figure 73 (Part 1 of 2) . Example 3; Stage I Input Deck 
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CKPTREST 

SORTMERG 

SORTLIB 

FORTRAN 

FORTLIB 

RPG 

TELCMLIB 

TSOPTION 

UADS 

CMDLIB 

EDIT 

OUTPUT 

HELP 

GENTSO 



ELIGBLE= (1,2,3,4,5) 

SORTOPT=FULLIB,SIZE=51200 

UNIT=23 1 1 , VOLNO=LINVOL 

DESIGNS 

DESIGN=G,UNIT=2311,VOLNO=LINVOL,OBJERR=03 



LOGLINE=100 

UNIT=231 1 , VOLNO=LINVOL 

BLOCK=(FORT-450, TEXT- 100) 

CLASS=(Z,Y) 

UNIT=231 1 ,VOLNO=LINVOL 

UT1SDS=SYS1. ONE, UT2SDS=SYS1. TWO, UT3SDS=SYS1. THREE, X 

UT4SDS=SYS1. FOUR, OBJPDS=SYS1. OBJECT, RESNAME=23 1 1, X 

RESVOL=SYSTEM,RESTYPE=2311,LINKNAME-2311, X 

LINKVOL=LINVOL, ASMPRT=ON, X 

DIRDATA=PDS,LEPRT=(LIST,XREF) ,CMDNAME=231 1 , X 

CMDVOL=LINVOL 



/* 
// 



END 
START 



RDR, 190 



Figure 73 (Part 2 of 2) . Example 3: Stage I Input Deck 



Backup of New System 



Figure 74 shows a listing of the IEHDASDR input deck used for creating the 
backup of the new system. IEHDASDR operates under control of the generating 
system on 111111. The backup copy of SYSTEM is made on the SYS001 magnetic 
tape volume. The backup copy of LINVOL is made on the SYS002 magnetic tape 
volume. After the two backup copies have been made, SYS001 and SYS002 should 
be removed and stored in the tape library. 



//BACKUP JOB MSGLEVEL=1 
// EXEC PGM=IEHDASDR 
//SYSPRINT DD SYSOUT=A 



-BACKUP- 



//SYSPACK 
//UNPACK 
//SYSTAPE 
//LINTAPE 
//SYSIN 



/* 



DD UNIT=2311,DISP=OLD,VOLUME=SER=SYSTEM 

DD UNIT=231 1 ,DISP=OLD,VOLUME=SER=LINVOL 

DD UNIT=2400,DISP=OLD, VOLUHE=SER=SYS001,LABEL= (,NL) 

DD UNIT=2400,DISP=OLD,VOLUME=SER=SYS002,LABEL= (,NL) 

DD * 

DUMP FROMDD=SYSPACK,TODD=SYSTAPE 

DUMP FROMDD=LINPACK,TODD=LINTAPE 



Figure 74. Example 3: Creating Backup of SYSTEM and LINVOL 



Scratching Utility Data Sets 



After the new operating system is generated, SYS1.0NE, SYS1.TWO, SYS1. THREE, 
and SYS 1. FOUR should be scratched and uncataloged. The job stream and 
SYS 1. OBJECT should be saved. Figure 75 shows a listing of the input deck used 
for scratching and uncataloging the three sequential data sets. The magnetic 
tape that contains the job stream can be removed from unit 190 and stored in 
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the tape library. SYS 1. MOD remains in the new system-residence volume (SYSTEM) 
to be used later in this example. The IEPBR14 program is executed under control 
of the generating system. 

//SCRATCH JOB MSGLEVEL=1 -SCRATCH DECK- 

//STEPO EXEC PGM=IEFBR14 

//SYSPRINT DD SYSOUT=A 

//SYSUT1 DD DSNAME=SYS1. ONE, DISP= (OLD, DELETE) 

//SYS0T2 DD DSNAME=SYS1.TW0,DISP=(0LD,DELETE) 

//SYS0T3 DD DSNAME=SYS1. THREE, DISP= (OLD, DELETE) 

//SYS0T4 DD DSNAME=SYS1. FOUR, DISP= (OLD, DELETE) 



Figure 75. Example 3: Scratching Utility Data Sets 



15ft OS System Generation 



Program Options Descriptions 



The descriptions of the control program options are provided in this chapter 
and arranged alphabetically. Each description contains a brief summary of 
the option's function, shows how to specify the particular option at system 
generation time, and provides a list of publications where further information 
can be found. 
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You can select various control program options to be included in your new 
system during system generation. What you select depends on the type of control 
program you plan to use, the amount of main storage available, and the types 
of job processing that will be done at your installation. 



Additional Pairs of Transient Areas 

Optional For: MVT (including M65MP) systems. 

One pair of supervisor (SVC) transient areas is always provided in an MVT 
system; additional pairs may be added. When a nonresident SVC routine is 
reguired during job execution, it is loaded into an available transient area 
If no transient areas are available, then the task reguiring the routine is 
placed in a wait state until one becomes available. 

Where to Find Information 

The information necessary to use the facility discussed above can be found 
in: 

• Storage reguirements — OS Storage Estimates 

What to C ode When Generating a System 

The following code is reguired to have additional pairs of transient areas 
included: 

CTRLPEOG . . . , ADDTRAN=number of pairs 

Alternate Path Retry (APR) 

Standard For: M65MP systems 
Optional For: MFT and MVT systems 



The alternate path retry (APR) option allows an I/O operation that has developed 
an error on one channel path to a device to be retried on another channel path 
to the same device. This can be done only if another channel path has been 
assigned to the device performing the I/O operation. APR also provides the 
capability to vary a path to a device online or offline by use of the VARY 
command. The VARY PATH is a standard function of APR. 

APR can handle: 

• Up to four paths to one device. 

• Two paths to a CPO for a multiprocessing system. 
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APR performs its function usefully only in a system that has the channel-check 
handler (CCH) and alternate paths to at least some of the I/O devices. 

How to Use 

The operation of the selective retry function of APR, in conjunction with the 
I/O supervisor, does not depend on anything you do. The operator can initiate 
the VARY path function by entering the VARY PATH command in the input stream 
or at the console. 

Where to Find Information 

Further information about APR can be found in: 

• Storage reguirements — OS Storage Estimates 

• How to enter commands — OS Operator's Procedures, OS Operator's Reference 

What to Code When Generating a System 

The following code is reguired to include alternate path retry (APR) in MFT 
and MVT systems: 

SOPRVSOR . ..,OPTIONS=(APR) 

For APR to be able to determine whether a device has an alternate path in an 
M65MP system, the following code should be specified for magnetic tape drives 
and 2314 drives. No other devices need this additional code. 

For magnetic tape drives: 

IOCONTRL ... ,FEATORE=(ALTCTRL) 
For 2314 drives: 

IODEVICE ...,FEATURE=(ALTCTRL) 

Note: If none of the I/O RMS options (APR, DDR, CCH) are chosen, IGF201 (the 
I/O RMS communications area) appears as an unresolved symbol. 



Attach Function 

Without Subtasking Standard For: MFT systems 

With Subtasking Standard For: MVT (including M65MP) systems 

With Subtasking Optional For: MFT systems 

There are two versions of the ATTACH function — with and without the subtasking 
capability. One of these versions is always part of every control program. 
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The ATTACH function without the subtasking capability passes control to another 
load module; when the requested load module terminates, control is returned 
to the program that issued the ATTACH macro instruction. 

The ATTACH function with the subtasking capability creates subtasks, so that 
the issuing program and the program requested in the ATTACH macro instruction 
compete for system resources. 

How to qse 

MFT systems can have either form of the ATTACH function. The version without 
subtasking is standard, and the version with subtasking can be specified. 
This ATTACH function allows more than one task to be executed within one 
partition. 

MVT systems have the ATTACH function with subtasking as a standard part of 
the control program. 

Where to Find Information 

Further information about the ATTACH function can be found in: 

• Storage requirements — OS Storage Estimates 

What to Code When Generating a System 

The following code is required to specify the ATTACH function with the 
subtasking capability for MFT systems: 

SOPRVSOR . . . ,OPTIONS= (ATTACH) 

MVT systems always have the ATTACH function with the subtasking capability; 
this is standard and should not be specified. 

Attach Function Made Resident 

Standard For: MVT (including M65MP) systems 

Optional For: MFT systems 

The routines that make up the ATTACH function can be made resident in main 
storage as part of the nucleus. If this function is not resident, every time 
an ATTACH macro instruction is issued the ATTACH routines are brought into 
the supervisor transient area. Making the ATTACH routines resident can be 
specified for MFT systems. It is always included as a standard feature in 
MVT and M65MP systems, and the storage required is included in the basic fixed- 
main-storage requirements for those systems. 

Where to Find Information 

Further information about how the ATTACH function routines is made resident 
can be found in: 

• Storage requirements — OS Storage Estimates 
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What to Code When Generating a System 

The following code is required to make the ATTACH routines resident for MFT 
systems: 

SUPRVSOR ...,RESIDNT= (ATTACH) 



Basic Direct Access Method (BDAM) 

Standard For: MVT (including M65MP) systems 

Optional For: MFT systems 

The basic direct access method (BDAM) can be included in the new operating 
system. 

Where to Find Information 

Further information about BDAM can be found in: 

• Storage requirements — OS Storage Estimates 

• How to use the CIRB macro instruction — OS MFT Guide, OS MVT Guide 

What to Code When Generating a System 

The following code is required to have BDAM included in new MFT systems: 

DATAMGT ACSMETH= (BDAM) 
If the CIRB macro instruction is going to be used in an MVT system, then code: 

MACLIB 

BLDL Table Made Resident 

Optional For: All systems 

Any or all of the SYS1.LINKLIB or SIS1.SVCLIB directory entries can be made 
resident in fixed main storage. No List is supplied for SYS1.SVCLIB. If you 
want a list for SYS1. SVCLIB, you must specify the operator communication option 
in the SUPRVSOR macro. You can modify this list to fit your requirements. 
If you create your own list, the operator communication option in the SUPRVSOR 
macro instruction must be specified so that your list can be brought in during 
system initialization. 
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How to Ose 

The standard list of SYS1.LINKLIB directory entries, IEABLDOO, can be made 
resident. This BLDL list has nine entries. If you plan to use your own BLDL 
list or a list for SYS1.SVCLIB, the operator communication option must be 
specified at system generation time in the OPTIONS parameter of the SUPRVSOR 
macro instruction. This causes the 'SPECIFY SYSTEM PARAMETERS 1 message 
(IEA101A) to be printed during execution of NIP and provides the operator with 
the opportunity to specify a BLDL list other than the standard one to be used 
during the loading of the nucleus. 

Where to Find Information 

The information necessary to use the BLDL table can be found in: 

Storage requirements — OS Storage Estimates 

SYS1.LINKLIB — OS System Generation 

Standard BLDL table — OS Storage Estimates 

Modifying the BLDL table — OS HFT Guide, OS MVT Guide 

Operator communication option — OS System Generation, OS Messages and 
Codes, OS Operator's Procedures, OS Operator's Reference 

What to Code When Generating a System 

The following code is required to make the BLDL table resident: 

SUPRVSOR ...,RESIDNT=(BLDLTAB) 

When you create your own list or a list for SYS1.SVCLIB, this code must be 
used: 

SOPRVSOR ...,RESIDNT=(BLDLTAB) ,OPTIONS= (COMM) 



Channel-Check Handler (CCH) 

Optional For: HFT and MVT Systems 

CCH supports the 2860, 2870, 2880, 135, 14*5, and 155 channels. CCH intercepts 
channel-check conditions, performs an analysis of the environment, and 
facilitates recovery from channel-check conditions by allowing for the 
scheduling of device-dependent error recovery procedures by the input/output 
supervisor, which will determine whether the failing channel operation can 
be retried. If CCH is not present in the system, one of the other recovery 
management facilities receives control and writes an error record for the 
channel failure. In this case, the error causes system termination. 

How to Ose 

This feature is optional in the S/360 Models 65, 75, and 91 if the models are 
specified in the CENPROCS macro instruction. 

It is automatically included in the S/360 Models 85 and 195 and S/370 Models 
135, 145, 155, 165, and 195 if the models are specified in the CENPROCS macro 
instruction. 
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CCH must be specified for a S/360 Model M65MP if the model is specified in 
the CENPROCS macro instruction. 

Where to Find Information 

The information necessary to use the channel-check handler can be found in: 

• Storage requirements — OS Storage Estimates 

• Operator action — OS Operator's Reference 

• Channel-check record processing — OS Utilities 

What to Code When Generating a System 

The following code is required to specify this option for the Models 65, M65MP, 
75, and 91: 

SUPEVSOR . .. ,OPTIONS=CCH 



Checkpoint/Restart 

Optional For: All systems 

Checkpoint/restart expands the use of the restart capabilities that are provided 
by the RD parameter of the JOB and EXEC statements. The RD parameter permits 
execution of jobs to be restarted automatically at a job step after abnormal 
termination occurs. 

Checkpoint/restart enables you to write checkpoint macro instructions (CHKPT) 
at various points in your program to record job status information. Then when 
an ABEND occurs, your program can be restarted automatically at the last of 
these points, or restart can be deferred until a later time, when the job can 
be resubmitted and the RESTART parameter in the JOB statement used. The RD 
parameter can also be used to partially or totally suppress checkpoint/restart. 

The following restrictions apply to the establishment of a checkpoint by the 
CHKPT macro instruction. 

• When the checkpoint is established, the job step must comprise a single 
task. The job step task must be the only task when the job step is 
restarted. 

• A checkpoint cannot be established by an exit routine that returns control 
to the control program. 

• If a STIMER or WTOR macro instruction has been issued, a checkpoint cannot 
be established before the time interval is completed or the operator* s 
reply is received. 

• In an MVT system with rollout/rollin, a checkpoint cannot be established 
when the job step has been allocated storage from outside its region. 

How to Use 

To use checkpoint/restart, you must indicate that you plan to use it at system 
generation time in the RESIDNT parameter of the SUPRVSOR macro instruction. 
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The basic modules required from the SVC library (SYS1.SVCLIB) for checkpoint/ 
restart will then be loaded automatically at NIP time. In the program that 
contains CHKPT macro instructions , a checkpoint data set and work area must be 
defined. The checkpoint/restart cataloged procedure (IEFREINT) must be included 
in SYS1.PR0CLIB either before or after system generation. 

Additional modules from the SVC library will be required if chained scheduling 
or track overflow are going to be used. You can obtain the additional modules 
by constructing your own access method option list (IEAIGGxx) and include it 
in the parameter library (SYS1.PARMLIB) . To use your own access method list, 
you must specify the operator communication option at system generation time 
in the OPTIONS parameter of the SUPRVSOR macro instruction. This causes the 
•SPECIFY SYSTEM PARAMETERS 1 message (IEA101A) to be printed during NIP and 
provides the operator with the opportunity to specify an access method option 
list other than the standard one to be used during the loading of the nucleus. 

Where to Find Information 

Further information about checkpoint/restart can be found in: 

• Detailed information — OS Advanced Checkpoint/Restart 

• RD parameter — OS Job Control Language Reference 

• Checkpoint macro instruction — OS Supervisor Services and Macro 
Instructions 

• RESTART parameter — OS Job Control Language Reference 

• SUPRVSOR macro instruction — OS System Generation 

• Access method option list — OS MFT Guide, OS MVT Guide 

• Storage requirements — OS Storage Estimates 

• Messages — OS Messages and Codes 

What to Code When Generating a System 



The following code is required to make it possible for you to use 
checkpoint/restart in your system: 

For MFT systems: 

SUPRVSOR . ..,RESIDNT=(ACSMETH) 
For MVT or M65MP systems: 

SUPRVSOR ...,RESIDNT=(RENTCODE) 

If your list has been built and added to SYS1.PARMLIB: 

SUPRVSOR ... r RESIDNT= (ACSMETH ) ,OPTIONS*= (COMM) 

RENTCODE 

To modify the standard list of ABEND codes that are eligible for automatic 
restart, or to add ABEND codes and make them eligible, use: 

CKPTREST 
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Consoles — Alternate and Composite Console Options 

Optional For: All systems 

One primary console must always be specified for any operating system except 
the M65MP system. M65MP must have two primary consoles specified except when 
the multiple console support (MCS) option is specified. (See the description 
in "Consoles - Multiple Console Support (MCS).") One alternate console can 
be specified, or two for the M65MP system when MCS is not selected. A composite 
console (such as a card reader and a printer) can be specified as a primary 
or an alternate console. The composite console is considered one console even 
though it may consist of two different physical devices. 

The following guidelines must be used when MCS is not selected: 

• A primary console must be specified in the SCHEDULR macro instruction. 

For M65MP: Two primary consoles must be specified in the SCHEDULE macro 
instruction. 

• A composite console can be used as a primary or an alternate console. 

For M65MP: No more than two of the total number of consoles specified 
can be composite consoles. 

• When a graphic device is going to be active as a console, a device that 
produces printed output must be specified. 

Where to Find Information 

Further information regarding alternate and composite console options can be 
found in: 

• Storage requirements — OS Storage Estimates 

What to Code When Generating a System 

The following code is required to specify consoles and alternate consoles when 
MCS is not specified: 

For MFT or MVT: 



SCHEDULR ... ,C0NS0LE= (address \ 

\(I~address,0-address)/ 

(address 

\ (I-address, O-address) 



, ALTCONS=/address ) 

if 



For M65MP: 



SCHEDULR ... ,C0NS0LE=/ (address ) (, address )\ 

\\ (I-address, 0-address)J (, (I-address, 0-address)f/ 

((address * (, address \\1 

((I-address, O-address)}" \, (I-address, O-address) f J 



, ALTC0NS= / (address 
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Consoles — Multiple Consoles Support (MCS) 

Optional For: MFT and MVT (including M65MP) systems 

If you want two or more consoles active during execution of an MFT or MVT 
system, you must specify the multiple console support (MCS) option in the 
CONOPTS parameter of the SCHEDULE macro instruction. 

How to Use 

One console must be specified in the SCHEDULR macro instruction; it is called 
the "master" console. An alternate console for the master console must be 
specified in the ALTCONS parameter of the SCHEDULE macro instruction. A 
SECONSLE macro instruction must be coded defining the alternate as a secondary 
console. Additional secondary consoles can be defined with SECONSLE macro 
instructions — up to a maximum of 31 secondary consoles. For all consoles 
for which no alternate console is specified, the master console is automatically 
assigned as the alternate* 

When MCS is specified, the M65MP system requirements are exactly the same as 
for the other MCS systems. However, it is recommended that the console for 
the other CPU be assigned as the alternate for the master console. 

A hard-copy log can be specified either at system generation or by the operator 
during system initialization or execution. A hard-copy log is required when 
there is more than one active console during initialization or execution, or 
when there is an active display console. The hard-copy log can be the system 
log that is contained on SYS1 . SYSVLOGX and SYS1. SYSVLOGY, or it can be a console 
with output capability. If the log is required, the system records the operator 
commands, the system commands and responses, and the messages with routing 
codes of 1, 2, 3, 4, 7, 8, and 10 on the hard-copy log. Additional messages 
can be recorded if desired. 

Routing codes and descriptor codes are required for all messages handled by 
a system using MCS. Messages that already exist can be assigned routing codes 
at system generation time or, by default, they will be sent to the master 
console. 

Routing codes are assigned to all new operator messages (WTO and WTOR) . They 
designate what function the message is connected with and determine where a 
message is to be sent. A system generation parameter provides the ability 
to supply routing codes to all operator messages that already exist and do 
not have routing codes. 

Each console is assigned one or more routing codes. The routing codes assigned 
to a console are matched to the routing codes assigned to WTO and WTOR messages. 
If there is a match, the message is sent to the console. Some messages, such 
as a message that is broadcast to all active consoles, are not routed by the 
routing code. 

Display areas may be defined for display consoles. Display areas are contiguous 
groups of four or more screen lines which are designated for use by status 
displays. 

Descriptor codes must be specified for all new operator messages. They are 
specified in the WTO or WTOR macro instructions. They designate how a message 
is to be printed or displayed. 

All commands have been arranged by function into four command code groups: 
informational, system control, I/O control, and console control. 
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An exit routine is provided just before the routing codes of a message are 
checked to enable you to supply your own routine to add, delete, or change 
routing and descriptor codes. (See OS MFT Guide or OS MVT Guide for a 
description of the exit routine.) 

The following guidelines must be used: 

• If HARDCPY=SYSLOG is specified in the SCHEDOLR macro instruction during 
system generation, then at IPL time the operator must change the HARDCPY 
parameter to refer to the address of an operator console that has output 
capability. The device should not be the master console. The HARDCPY 
specification can be changed back after the message IEE14 1I has been 
received. (For detailed operating instructions, see OS Operator's 
Reference. ) 

• A master console must be specified in the CONSOLE keyword parameter of 
the SCHEDULR macro instruction. 

• An alternate console to the master console must be specified in the ALTCONS 
keyword parameter of the SCHEDOLR macro instruction. 

• The alternate for the master console must be defined in the CONSOLE 
parameter of a SECONSLE macro instruction to make it a secondary console. 

• A console with at least printing output capability must be specified as 
the hard-copy log. Although the system log is not a console, and does 
not directly produce printed output, it can be used. 

• A record of the operator commands, system commands and responses, and 
routing codes 1, 2, 3, 4, 7, 8, and 10 should be maintained. 

• Up to 31 secondary consoles can be specified with SECONSLE macro 
instructions. They can all have alternate consoles specified. If no 
alternate is defined, then the master console automatically becomes the 
alternate. 

• A 2250 display unit can be specified as a master, secondary, or alternate 
console. A display console with input and output capability (a full 
capability console) can be specified as a master, secondary, or alternate 
console. A display console with no input capability (an output only 
console) or limited light pen input capability (a limited capability 
console) should not be specified as a master or alternate console. 

• A 2260 display station can be specified as a master, secondary, or alternate 
console. It may also be designated as an output-only console for display 

of either general messages or status displays. 

• One or more display areas may be defined for each display console in the 
system. 

• Any number of the consoles can be composite consoles. 

• Routing and descriptor codes are assigned to all new operator messages 
that are written. 
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Where to Find Information 

Further information about MCS can be found in: 

SCHEDULR and SECONSLE macro instructions — OS System Generation 

Hard-copy log — OS Operator 1 s Reference, OS System Generation 

System log — OS Operator's Reference, OS System Generation 

Operator commands — OS Operator's Reference 

Display (CRT) consoles — OS Operator's Guide for Display Consoles 

Messages — OS Messages and Codes 

Routing codes — OS Messages and Codes, OS Supervisor Services and Macro 
Instructions, OS Operator's Reference 

Descriptor codes — OS Messages and Codes, OS Supervisor Services and Macro 
Instructions, OS Operator's Reference 

Master, secondary, and alternate consoles — OS Operator's Reference, OS 
System Generation 

Storage requirements — OS Storage Estimates 

WTO and WTOR macro instructions — OS Supervisor Services and Macro 
Instructions 

Command code group — OS Operator's Reference 

SYS1.SYSVL0GX and SYS 1.SYSVLOGY — OS System Generation 

User exit routine — OS MFT Guide, OS MVT Guide 

What to Code When Generating a System 

The following code is required to specify the master, the secondary, and the 
alternate consoles: 



SCHEDULR 

,ALTCONS= 



/address ) 

\ (I-address, O-address)/ 
(address ) 

\ (I-address, O-address)/ 



CONOPTS= (MCS/ ,NOEXIT)) 
{EXIT / 

["ROUTCDE=h )"] 

L I (routing code[ , routing code]...)/J 

[OLDWTOR= (routing code[ , routing code]...) ] 

HARDCPY=(fSYSLOG ) 
(address/ 
/rALL \ 

\, (routing code[ , routing code]...)/ 

(,NOCMDSW,INCMDS) 

(,CMDS /(,STCMDS/ 
AREA=(nn[ ,nn.. . ]) ] 
OPSTRAN=nn] 
[PFK=nn] 
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SECONSLE CONSOLE=/address 

O-address 

(I-address 



[,OSE=|SDp! 
, O-address) / 

} 



,ALTCONS= (address 

<0-address 

( (I-address, O-address)^ 

["ROUTCDE=|ALL )~| 

L \ (routing code[ , routing code ]...); J 

[VALDCMD= (command code[ , command code]...)] 

[ AREA= (nn[ ,nn. . . ]) ] 

[OPSTRAN=nn] 

[PFK=nn] 

Conversational Remote Job Entry (CRJE) 

Optional For: HFT and HVT (including W65SP) systems. 

Conversational remote job entry (CRJE) provides remote access to the operating 
system from printer-keyboard terminals. Authorized terminal users can 
conversationally prepare and update programs and data, submit them for OS 
background processing, and receive the output either at the central installation 
or at the remote terminal. 

How to Ose 

Conversational remote job entry (CRJE) requires the basic telecommunication 
access method (BTAM) routines. Background execution of CRJE-submitted jobs 
is accomplished concurrently with normal batch processing under the supervision 
of the OS job management routines. The valid CRJE terminal user is one that 
has been defined in the system at CRJE assembly time in the CRJEUSER macro 
instruction or has been added to the system by the central operator using the 
USERID central command. 

The terminal user can insert, replace, delete, or change information to be 
submitted in jobs by using the CRJE data set updating facilities. He can have 
PL/I or FORTRAN source statements checked for syntax errors before submitting 
the job. The syntax checking program (s) are included at system generation 
time by the CHECKER macro instruction. 

The terminal user can inguire about the status of the system or remotely 
submitted jobs. There is also a message facility for two-way communication 
between terminal users, and between terminal users and the central operator. 

CRJE is specified at system generation time in order to have the necessary 
modules included in the system. After generation, you must create the specific 
CRJE system required for your installation. There are three macro instructions 
available for this job — CRJELINE, CRJETABL, and CRJEUSER. You set up a job 
that includes the CRJE macro instructions necessary to specify your system; 
you may include your own routines. The assembler translates these macro 
instructions and creates the required modules. The linkage editor incorporates 
the modules into the operating system. 

SYS1.MACLIB must be in the operating system so that the assembler can expand 
the macro instructions. SYS1.TELCMLTB must be in the system to hold some of 
the CRJE load modules as well as the telecommunication subroutines. Enough 
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system queue space must be specified in the CTRLPROG macro instruction during 
system generation to handle the necessary CRJE space requirements. 

Where to Find Information 

Further information about CRJE can be found in: 

• Machine requirements — OS CRJE System Programmer's Guide 

• Generating the CRJE system — OS CRJE System Programmer's Guide 

• CRJE facilities — OS CRJE System Programmer's Guide 

• BTAM information — OS CRJE System Programmer's Guide 

• System queue space — OS CRJE System Programmer's Guide, OS Storage 
Estimates 

• CRJE macro instructions — OS CRJE System Programmer's Guide 

• System generation macro instructions — OS System Generation 

• Specifying system data sets -- OS System Generation 

• Storage requirements — OS CRJE System Programmer's Guide, OS Storage 
Estimates 

What to Code When Generating a System 

The following system data sets and options must be specified: 

SYS1.MACLIB 

STS1.PR0CLIB 

SYS1.TELCMLIB 

An Assembler 

A Linkage Editor 

The following code is required to support CRJE: 

DATAMGT ACSMETH=BTAH 

IOCONTRL — One for each telecommunications control unit. 

IODEVICE — One for each telecommunications line. 

SCHEDULE .. .,OPTIONS=CRJE,... 

PROCLIB 
For HFT: 

SOPRVSOR . . . , OPTIONS* ATTACH 
To include syntax checking: 

CHECKER 
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Decimal Simulation Option for Model 91 

Optional For: MVT systems 

The decimal simulation option provides the Model 91 with the ability to handle 
decimal arithmetic instructions; the Model 91 is not equipped with decimal 
arithmetic instruction circuitry. This option requires both a lonq execution 
time and that the CPU not be operational during the simulation. The universal 
instruction set, which is standard for the Model 91, includes only the EDIT 
and EDMK decimal instructions; any other decimal instruction is simulated. 
This option should be specified if COBOL, PL/I, or RPG is to be included in 
the system, or if decimal arithmetic instructions are to be used in assembler 
lanquaqe. 

Where To Find Information 

Further information about the decimal simulation option can be found in: 
• Storaqe requirements — OS Storage Estimates 

What to Code When Generating a System 

The followinq code is required to specify this option: 

S0PF.VSOR ...,OPTIONS=(DECSIM) 
Althouqh the universal instruction set is assumed, it can be specifed by: 

CENPROCS .. .,INSTSET=UNIV 

Direct-Access Volume Serial Number Verification 

Optional For: All systems 

You can add direct-access volume serial number verification to your new system. 
If you do, the volume serial number of a direct-access device is checked after 
an unsolicited device-end interrupt condition has been corrected and the volume 
has been put back online again. 

How to Use 

When an unsolicited device-end interrupt is received from a direct-access 
device, the I/O supervisor (IOS) ensures that the volume serial number of the 
mounted volume agrees with the volume serial in the unit control block (UCB) . 

The code to do the checking is included at system generation time unless NODAV 
is specified in the OPTIONS keyword parameter of the SOPRVSOR macro instruction. 
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Where to Find Information 

Further information about direct-access volume serial number verification can 
be found in: 

• Storage requirements — OS Storage Estimates 

What to Code When Generating a System 

The following code is required to delete this option: 

SOPRVSOR . . .,OPTIONS=(NODAV) 

Note: If OPTIONS=DDR is specified, this option is automatically included, 
so that if OPTIONS=NODAV is coded, it is ignored. 

Dynamic Device Reconfiguration (DDR) 

Standard For: M65MP systems 

Optional For: MFT and MVT systems 

The dynamic device reconfiguration option allows a demountable volume to be 
moved from one device to another and repositioned if necessary without 
abnormally terminating the job or redoing IPL. A request to move a volume 
may be initiated by either the system or the operator. 

How to Use 

The outboard recorder routine of the I/O Supervisor transfers control to the 
DDR routines when a permanent I/O error occurs. These routines then determine 
if it is possible to correct the error by moving a volume to another device. 
If it is, the system requests a volume swap by issuing a message to the 
operator. The operator must answer this message. 

Sometimes the operator will determine that volumes need to be swapped. He 
can initiate this action by entering a SWAP command. 

The DDR routines will be used if: 

• DDR, DDRSYS, or DDRNSL has been specified in the OPTIONS keyword parameter 
of the SDPRVSOR macro instruction during system generation. 

• The device that has a permanent I/O error is a 2311, 2314, 2321, 3330, 
any 2400 or 3400 series magnetic tape drive, a card reader, a printer, 
or a card punch. No teleprocessing devices are supported. Any volume 

on a device for which shared DASD has been specified can only be demounted 
and remounted on the same device. The DDR routines can be used for the 
unit record devices only if the operator issues the request by means of 
the SWAP command when intervention is required. 

• The type of permanent I/O error is supported. The ones that are not 
supported are: wrong length record, no record found, unit exception, 
program check, protection check, IOB intercept condition, backing to load 
point, or a permanent I/O error caused by the channel program. 
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Notes: 

• You should not code specific unit addresses in programs that will be 
processed on a system that has DDR. 

• The direct-access serial number verification routines must be in the system 
that has the DDR routines. 

For FETCH: When I/O errors occur while the FETCH routines are addressing the 
SVCLIB, the DDR system-residence routines receive control, and, if possible, 
reguest a swap. For this to occur, OPTIONS=DDRSYS must be specified in the 
SOPRVSOR macro instruction and the conditions listed above must exist. 

For DDR System-Residence Routines: When these routines are specified in the 
OPTIONS keyword parameter of the SOPRVSOR macro instruction, another keyword 
parameter, ALTSYS, must also be specified. 

If high availability is important to the installation, a duplicate system- 
residence volume is advisable. However, to use such a volume, writing on any 
part of the system-residence volume other than SYS1.L0GREC would have to be 
prohibited. 

The system-residence device specified during system generation can be changed 
at IPL time by the operator. OPTIONS=COMM must be specified in the SOPRVSOR 
macro instruction during system generation to make this change possible. 

For Nonstandard Labels: If you want DDR and have nonstandard magnetic tape 
labels, OPTIONS=DDRNSL must be specified. A nonstandard label routine with 
the name NSLREPOS must be supplied. This routine can either be added during 
system generation using the SVCLIB macro instruction, or be link-edited into 
SVCLIB after the system generation process is completed. 

For DDR When EXCP is Used: When the EXCP macro instruction is used to address 
magnetic tape drives in a program that runs under a system with DDR, REPOS=Y 
or N must be coded in the DCB macro instruction to indicate whether an accurate 
block count is being maintained. 

Where to Find Information 



Further information about DDR can be found in: 
SWAP command — OS Operator's Reference 

System generation macro instruction -- OS System Generation 
Nonstandard label routine — OS Tape Labels 
Shared DASD devices — OS System generation 

EXCP macro instruction — OS Data Management for System Programmers 
Storage reguirements — OS Storage Estimates 



172 OS System Generation 



What to Code When Generating a System 

The following code is required to specify that the dynamic device 
reconfiguration (DDR) routines are to be included in MFT and MVT systems: 

SOPRVSOR . . .,OPTIONS=(DDR) 

When this option is specified, the direct-access volume serial number 
verification (DAV) is automatically included. If OPTIONS=NODAV is coded, it 
is ignored. 

To include the DDR routines to handle system-residence volumes: 

SOPRVSOR . ..,OPTIONS=(DDRSYS) , 
ALTSYS=address 

To include the DDR routines to handle magnetic tape volumes with nonstandard 
labels: 

SOPRVSOR . . .,OPTIONS=(DDRNSL) 

To change the system-residence device address at IPL: 

SOPRVSOR .. .,OPTIONS= (COHM) 

Note: If none of the I/O RMS options (APAR, DDR, CCH) are chosen, IGF20 1 (the 
I/O RMS communication area) appears as an unresolved symbol. 



Extract Function Made Resident 

Standard For: MVT (including M65MP) systems 

Optional For: MFT systems 

The routines that make up the EXTRACT function can be made resident in main 
storage as a part of the nucleus. If this function is not resident, every 
time an EXTRACT macro instruction is issued, the routines are brought into 
the supervisor transient area. 

The EXTRACT function that is included in an MFT system with subtasking is the 
same as the EXTRACT function in an MVT system. 

The EXTRACT macro instruction provides your program with information contained 
in specified fields of the task control block (TCB) of either the task that 
issued the macro instruction or, in a multiprogramming environment, one of 
its subtasks. 

Where to Find Information 

Further information about how the extract function is made resident can be 
found in: 

• Ose of EXTRACT -- OS MFT Guide, OS MVT Guide, OS Data Management Services 
Guide 

• EXTRACT macro instruction — OS Supervisor Services and Macro Instructions 

• Storage requirements — OS Storage Estimates 
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What to Code When Generating a System 

The following code is required to make the EXTBACT routines resident for MFT 
systems: 

SUPRVSOR ...,RESIDNT= (EXTRACT) 



Graphic Programming Services 

Optional For: All systems 

The graphic programming services control graphic input and output and a set 
of problem-oriented routines that are used as building blocks in the 
construction of graphic processing programs. The graphic subroutine package 
(GSP) allows the FORTRAN IV or PL/I F programmer to use the graphic programming 
services. 

How to Use 

The problem-oriented routines generate graphic instructions for displaying 
various images and alphameric information on the 2250 display unit. These 
routines function as part of the problem program and are reached by a CALL 
or LINK macro instruction. 

Where to Find Information 

Further information about graphic programming services can be found in: 

• Storage requirements — OS Storage Estimates 

• Detailed information — OS GPS for IBM 2250 Display Pnit, OS GPS for IBM 
2260 Display Station (Local Attachment), OS GPS for IBM 2280 and 2282 
Display Units 

What to Code When Generating a System 
The following code is required for this option: 
GRAPHICS PORRTNS=INCLUDE,GSP=INCLUDE 



Identify Function Made Resident 

Standard For: MVT (including M65MP) systems 

Optional For: MFT systems 

The routines that make up the IDENTIFY function can be made resident in main 
storage as a part of the nucleus. If these routines are not resident, every 
time an IDENTIFY macro instruction is issued, the routines are brought into 
the supervisor transient area. If the IDENTIFY module is resident, performance 
improves, but the amount of required fixed main storage increases. 
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How to Use 

The IDENTIFY macro instruction is used to inform the supervisor of an embedded 
entry point within a load module. 

After the IDENTIFY macro instruction has been executed, the entry point can 
be referred to by an ATTACH, LINK, XCTL, or LOAD macro instruction. 

Where to Find Information 

Further information on how the identity function is made resident can be found 
in: 

• IDENTIFY macro instruction — OS Supervisor Services and Macro Instructions 

• Storage requirements — OS Storage Estimates 

What to Cods When Generating a System 

The following code is required to specify the option for MFT: 
SOPRVSOR ...,RESIDNT= (IDENTIFY) 



Indexed Sequential Access Method (ISAM) 

Optional For; All systems 

The indexed sequential access method can be included in the new system so that 
tasks can use the basic indexed sequential access method (BISAM) or the queued 
indexed sequential access method (QISAM) . 

Where to Find Information 

Further information about ISAM can be found in: 

• Storage requirements — OS Storage Estimates 

• How to use CIRB macro instruction — OS MFT Guide, OS MVT Guide 

What to Code When Generating a System 

The following code is required to include ISAM in the new system: 

DATAMGT ACSMETH= (ISAM) 
If CIRB is desired in an MVT system: 

MACLIB 
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Job Step Timing 

Optional For: All systems 

Each job step can be timed and the time limits enforced. The amount of time 
used is recorded after a job step is finished. In addition, the following 
are included in this option: the ability to request the date plus the time 
of day, to change the time at midnight, and to request, check, and cancel 
intervals of time. (See the description of "Timing Options" later in this 
section. ) 

Where to Find Information 

Further information about job-step timing can be found in: 

• Amount of storage required — OS Storage Estimates 

What to Code When Generating a System 

The following code is required to specify this option: 
SUPRVSOR ...,TIMER=JOBSTEP 



Main Storage Hierarchy Support 

Optional For: All systems 

Main storage hierarchy support provides selective access to either processor 
storage or the IBM 2361 Core Storage. 

How to Use 

Main storage is divided into two blocks known as hierarchies; hierarchy is 
assigned to processor storage and hierarchy 1 to the 2361. To use hierarchies, 
program controlled interrupt (PCI) must always be specified. (See the 
description of "Program Controlled Interrupt (PCI) FETCH" later in this 
section.) 

For MFT systems, if there is not a 2361 unit on the system, any references 
to hierarchy 1 will have to be redefined at IPL time. Hierarchies for 
partitions in MFT are defined in the PARTITNS system generation macro 
instruction. 

For MVT systems, the hierarchy structure is maintained even though there may 
not be a 2361 unit on the system. 

Where to Find Information 

Further information about main storage hierarchy support can be found in: 

• Storage requirements — OS Storage Estimates 

• Detailed information — Introduction to Main Storage Hierarchy Support 
for IBM 2361, Mod 1 and 2 under OS 
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What to Code When Generating a System 

The following code is required to have this option included in the new system; 



For MVT: 

CTRLPROG 

For MFT: 

CTRLPROG 
PARTITNS 



...,HIARCHY=INCLUDE 

. . . , HIARCHY=INCLUDE,FETCH=PCI 
(operand[ ,operand]. . .) 



PL/ 1 F Shared Library Feature 

Optional For: MFT or MVT (including M65MP) systems 

This feature permits you to create a resident load module that contains common 
routines and makes this load module accessible from all partitions or regions. 
These often-used modules would otherwise be link-edited into the compiler 
output module in each program that uses them. With this feature, they are 
made into a separate resident module available to any program. 

This feature can be used only with an operating system that is of Release 18 
level or later. 



How to Ose 



The modules that are to be placed in the resident load module are 
in the parameters for the PL1LIB macro instruction at system gene 
The load module is created at system generation and is placed in 
with the member name of IHELTVA. You must construct a reentrant 
with the member IHELTVA in it. The list is placed in SYS1.PARMLI 
time. At IPL time, the message (IEA101A) 'SPECIFY SYSTEM PARAMET 
out. The operator must reply RAM=nn, where nn represents the two 
when the list name was created. This will cause the PL/I shared 
to be included in the resident portion of main storage. 



specified 
ration time. 
SYS1.LINKLIB 
list (IEAIGGnn) 
B before IPL 
ERS* is typed 

digits used 
library module 



COMM must be specified in the OPTIONS parameter and RENTCODE must be specified 
in the RESIDNT parameter of the SUPRVSOR macro instruction. 

Where to Find Information 

Further information about the PL/I shared library feature can be found in: 

• PL1LIB and SUPRVSOR macro instructions — OS System Generation 

• Shared library — OS PL/I (F) Programmer's Guide 

• List creation — OS MFT Guide, OS MVT Guide 

• Messages — OS Messages and Codes 
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• Storage requirements — OS Storage Estimates 

• Operating procedures — OS Operator's Procedures, OS Operator's Reference 

What to C ode When Generating a System 

The following code is required to specify this option: 

SUPRVSOR RESIDNT=RENTCODE, 
OPTIONS=COMH 

PL1LIB MODES=( NOTK [ ,REAL ][ ,CMPX ]) 

TASK 
[ STORG= (operand[ , operand ]. . 
[CONVS= (operand[ , operand].. 
[ STRGS= (operand[ , operand ]. . 
[ ARRAY= (operandf , operand ]. . 
[ MATHS= (operand[ , operand ]. . 
[ STRIO= (operand[ , operand ]. . 
[ RECIO= (operand[ , operand]. . 



Program Controlled Interrupt (PCI) 

Optional For: MFT 

Program controlled interrupt (PCI) permits the program to cause an I/O 
interruption during execution of an I/O operation. PCI provides a means of 
alerting the program of the progress of chaining during an I/O operation. 
It also permits programmed dynamic main-storage allocation. 

PCI fetch is able to bring a program into main storage with only one seek of 
the disk if: 

• A buffer is always available for relocation dictionaries. 

• No errors occur during the I/O operation. 

• No cylinders are crossed while bringing in the program. 

• The speed of the central processing unit allows PCI to modify the 
channel command word before it reaches the channel. 

An additional WAIT and seek are required each time a buffer is not available. 
A seek is required each time an error occurs or a cylinder is crossed. If 
the speed of the central processing unit does not allow PCI to perform its 
function in time, the number of seeks needed by the standard fetch are required. 
If H I ARCHY= INCLUDE is specified in the CTRLPROG macro, then PCI is automatically 
included. 

Where to Find Information 



Further information about PCI can be found in: 
• Storage requirements — OS Storage Estimates 
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What to Code When Generating a System 

The following code is required in order to specify this option: 
CTRLPROG . . .,FETCH=PCI 

Reenterable Load Modules Made Resident 

Optional For ; All systems 

Reenterable load modules from the SYS1 .LINKLIB and SYS1.SVCLIB can be made 
resident. MFT systems can have only user-written load modules and the loader 
program modules from LINKLIB made resident in the reenterable load module area; 
MVT and M65MP systems can have modules from either or both libraries made 
resident in the link pack area. 

How to Use 

There are standard lists that are used during IPL to place the load modules 
from the libraries into the fixed portion of main storage: IEAIGGOO for 
SYS1. LINKLIB and IEARSVOO for SYS1.SVCLIB. If the user wishes to create his 
own list, then the operator communication option (OPTIONS=COMM) must be 
specified in the SUPRVSOR macro instruction. This causes the message (IEA101A) 
to print out 'SPECIFY SYSTEM PARAMETERS 1 . Then the operator provides the 
unigue identification for the list. The reenterable load modules pointed to 
by the list are loaded into main storage at IPL time. 

Where to Find Information 

Further information about reenterable load modules being made resident can 
be found in: 

Storage requirements — OS Storage Estimates 

Standard list — OS Storage Estimates, OS MFT Guide. OS MVT Guide 

Operator communication option — OS System Generation 

Messages — OS Messages and Codes 

Operator action — OS Messages and Codes, OS Operator's Procedures, OS 
Operator's Reference 

What to Code When Generating a System 

The following coding is required to specify the option: 

SUPRVSOR ...,RESIDNT-(RENTCODE) 

If the operator communication option is required, the following coding is 
required: 

SUPRVSOR . . . , RESIDNT= (RENTCODE) , OPTIONS= (COMM) 
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Remote Job Entry (RJE) 

Optional For: All systems 

The remote job entry (RJE) facility provides a method of entering jobs from 
remote work stations into the job stream. Once the jobs have been entered, 
execution proceeds under the supervision of the operating system. Any output 
data sets created by a remotely submitted job that the terminal user wants 
returned are placed in a separate output class and then sent to him. 

How to Ose 

The RJE facility operates under the operating system on a computer-based 
telecommunications system; it requires the basic telecommunications access 
method (BTAM) routines. RJE is specified at system generation time in order 
to have the necessary modules included in the system. 

After generation you must create the specific RJE system required for your 
installation. There are four macro instructions available for this job -- 
RJETERM, RJELINE, RJEUSER, and RJETABL. You must set up a job that includes 
the RJE macro instructions necessary to specify your system; you may include 
your own routines. The assembler translates these macro instructions and 
creates the required modules. The linkage editor incorporates the modules 
into the operating system. SYS1.MACLIB must be in the operating system so 
that the assembler can expand the macro instructions. SYS 1.TELCMLIB must be 
present in the operating system also to hold some of the RJE load modules as 
well as the telecommunications subroutines. 

Enough system write-to-operator (WTO) buffers must be specified in the WTOBFRS 
parameter of the SCHEDULR macro instruction during system generation so that 
an RJE task will not have to wait to display a message. If a wait occurs, 
a work station timeout could result. A recommended value for the number of 
buffers is twice the number of telecommunications lines in the system. 

Where to Find Information 

Further information about RJE can be found in: 

• Machine requirements — OS RJE 

• RJE macro instructions — OS RJE 

• System generation macro instructions — OS System Generation 

• Specifying system data sets — OS System Generation 

• Storage requirements — OS RJE, OS Storage Estimates 

What to Code When Generating a System 

The following system data sets and options must be specified: 

SYS1.MACLIB 

SYS1.PR0CLIB 

SYS1.TELCMLIB 

An assembler 

A linkage editor 
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The following code is required to support RJE: 
DATAMGT ACSMETH= (BTAM,BDAM) 

IOCONTROL — One for each telecommunications control unit. 
IODEVICE — One for each telecommunications line. 
PROCLIB 
SCHEDULR ... ,OPTIONS=(RJE) , WTOBFRS=number 

Resident Access Method Routines 

Optional For: MFT systems 

Reenterable access method load modules can be made resident from the 
SYS1.SVCLIB. Modules IGG019FN, IGG019FP, and IGG019C4 should be made resident 
if you are using the search direct option. When these modules are resident, 
performance is improved and required region size is decreased. 

How to Use 

The standard list, IEAIGGOO, contains the names of the access-method routines 
that are to be loaded and made resident by IPL. If you want to create your 
own list to load certain modules, then the operator communication option 
(OPTIONS=COMM) must be specified in the SUPRVSOR macro instruction. Then at 
IPL time the message (IEA101A) will print out 'SPECIFY SYSTEM PARAMETERS 1 . 
The operator answers with the unique identification numbers for your list. 
The access-method routines that are pointed to by this list will then be loaded 
into main storage at IPL time. 

Where to Find Information 

Further information about resident access method routines can be found in: 

• Storage requirements — OS Storage Estimates 

• Standard list — OS Storage Estimates, OS MFT Guide, OS MVT Guide 

• Operator communication option — OS System Generation 

• Messages — OS Messages and Codes 

• Operator action — OS Messages and Codes, OS Operator's Procedures, OS 
Operator's Reference 

What to Code When Generating a System 

The following code is required to specify this option: 

SUPRVSOR ...,RESIDNT=(ACSMETH) 

If the operator communica-tion option is also specified, the coding required 
is: 

SOPRVSOR . . . ,RESIDNT= (ACSMETH) , OPTIONS* (COMM) 
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Rollout/ Rollin Option 

Optional For: MVT (including M65MP) systems 

A job step can temporarily expand its specified region. A job step's region 
size can be based on a minimum actual requirement, rather than a maximum one. 

How to Use 

When a job step needs more main storage, an attempt is made to obtain it from 
unassigned storage. If none is available, another job step is rolled out, 
that is, its entire region is transferred to secondary storage, and its storage 
is made available to the first job step. When released by the first job step, 
the additional storage is again available as unassigned storage, if that was 
its source. The additional storage may also be available to receive the rolled- 
out job step, which is transferred back into main storage (rolled in) . Through 
job control you specify jobs eligible to be rolled out or to cause rollout. 
Exits are provided at key decision points where installation-written routines 
can be added to expand, redirect, or limit, the feature's operation. 

The data set SYS 1. ROLLOUT must be cataloged in the new system before IPL. 
Where to Find Information 

Further information about the rollout/rollin option can be found in: 

• Storage requirements — OS Storage Estimates 

• Exit routines — OS MFT Guide, OS MVT Guide 

• SYS1E0LL00T — OS System Generation. 

• Job control statements — OS Job Control Language Reference 

What to Code When Generating a System 

The following code is required to specify this option: 
CTRLPROG . . . , OPTIONS= (ROLLOUT) 

Shared DASD 

Optional For: All systems 

Two central processing units can access the same direct-access device 
concurrently. 

Where to Find Information 

Further information about shared DASD can be found in: 

• General information — OS MVT Guide 
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• Amount of storage required — OS Storage Estimates 

• Operator information — OS Operator's Reference 

• Functions, operating environment, and volume acceptability — OS Data 
Management for System Programmers 

What to Code When Generating a System 

The following code is required to specify this option: 

Either — IOCONTRL . . . , FEATURE=SHARED 

Or — IODEVICE . ..,FEATURE=SHARED (For 23 14 only) 



SPIE Routines Made Resident 

Standard For; MVT (including M65MP) systems 

Optional For: MFT systems 

The set program interruption element (SPIE) function can be made resident. 
If this function is not resident, it is brought into the supervisor transient 
area whenever a SPIE macro instruction is executed. 

The SPIE macro instruction specifies the address of a routine to be used when 
specified program interruptions occur in the task that issued the macro 
instruction. 

Where to Find Information 

Further information about SPIE routines being made resident can be found in: 

• Amount of storage required — OS Storage Estimates 

• SPIE macro instruction — OS Supervisor Services and Macro Instructions 

What to Code At System Generation Time 

The following code is required in order to specify this option: 
SUPRVSOR ...,RESIDNT=(SPIE) 
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Storage Protection Option 

Required For: MVT (including M65MP) systems 
Optional For: MFT systems 

When the storage protection option is included in the central processing unit, 
it may be specified. The validity check option is included also, but as a 
standard feature when this option is specified. 

How to Use 



When the storage protection option is specified, the size of each protected 
area must be a multiple of 2,048 bytes. 

The storage protection machine option is a standard feature for models 50 and 
larger, but the storage protection programming option must be specified during 
system generation. For all systems, if the storage protection programming 
option is specified, the validity checking function is included and cannot 
be specified in the system generation coding. 

Where to Find Information 



Further information about the storage protection option can be found in: 
• Amount of storage required — OS Storage Estimates 

What to Code When Generating a System 

The following code is required in order to specify this option: 

CENPROCS ...,FEAT0RE=PROTECT (For Model 40) 

SUPRVSOR ...,OPTIONS= (PROTECT) 

System Management Facilities (SMF) 

Optional For: All systems 

The system management facilities (SMF) are a group of routines that collect 
and record data about how the system and the I/O devices were used by the jobs 
and the job steps. For the M65MP systems these routines collect and record 
data about the use of central processing units, channels, and storage, as well 
as I/O devices. The data that is collected by the SMF routines is put on one 
or two data sets (SYS1.MANX and SYS1.MANY) — one if magnetic tape is used, 
or two if direct -access devices are used. Six exits are provided, so that 
you can supply your own exit routines to supplement the SMF option. The data 
collected can be recorded on your own or the SMF data sets. 

How to Ose 

To use SMF, you must specify the ACCTRTN parameter in the SCHEDULR macro 
instruction and the TIMER parameter in the SUPRVSOR macro instruction at system 
generation time. A definition list (SMFDEFLT) should be placed in the parameter 
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library (SYS1.PARMLIB) before the first IPL. (This list can be put in either 
before or after system generation.) The definitions in the list provide the 
factors that determine which functions SMF will perform and whether any of the 
six exits (IEFUJV, IEFUJI, IEFUSI, IEFACTRT, IEFUTL, IEFUSO) is to be used. 
If you have written one or more routines to supplement SMF, they may be placed 
in SYS1.CI505 before system generation is started. 

The SMF macro instruction (SMFWTM) ana the SMF dump routine (IFASMFDP) are 
included automatically at system generation time as part of the SMF routines. 
The macro instruction is used to write your data records onto the SMF data 
sets from the SMF I/O buffer. The dump routine should be used, if the data 
sets are on direct-access devices, to dump the contents to magnetic tape. 
A sample program (TESTEXIT) to test the SMF routines and any of your routines 
is provided in the sample library (SYS1. SAMPLIB) of the starter operating 
system (see the SMF publication for a discussion of the sample program) . 

Where to Find Information 

Further information about SMF can be found in: 

SMF data sets defined — OS System Generation 

User exits — OS SMF 

Definition list — OS SMF 

SCHEDULE and SOPRVSOR macro instructions — OS System Generation 

SMF I/O buffer — OS Storage Estimates 

SMF macro instruction (SMFWTM) — OS SMF 

SMF dump program (IFASMFDP) — OS SMF 

Parameter library (SYS1.PARMLIB) — OS System Generation 

Sample programs — OS SMF 

Specifying SMF — OS System Generation 

Storage reguirements — OS Storage Estimates 

What to Code When Generating a System 

The following code is reguired to permit you to use the SMF routines in your 
system: 

SCHEDULR . . , ACCTRTN=SMF 

SUPRVSOR ...,TIMER=JOBSTEP 
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Telecommunications Option 

QTAM, TCAM, and BTAM Optional For: All systems 

A telecommunications option can be included in the new system so that tasks 

can use the basic telecommunications access method (BTAM) , the queued 

telecommunications access method (QTAM) , or the telecommunications access 
method (TCAW) . 

Where to Find Information 

Further information about the telecommunications option can be found in: 

• Amount of storage required — OS Storage Estimates 

• How to use the CIRB macro instruction — OS MFT Guide, OS BYT Guide 

What to Code When Generating a System 

The following code is required to have this option in the new system: 

DATAMGT ACSMETH= (BTAM) or 

DATAMGT ASCMETH= (QTAM) or 

DATAMGT ACSMETH= (TCAM) or 

DATAMGT ACSMETH= (BTAM, QTAM) or 

DATAMGT ACSMETH= (BTAM, TCAM) or 

DATAMGT ACSMETH= (QTAM, TCAM) or 

DATAMGT ACSMETH= (BTAM, QTAM , TCAM) 

TELCMLIB UNIT=name,VOLNO=serial 

If CIRB is desired in an MVT system: 

MACLIB 

Timing Options 

TIME Optional For: MFT systems 

INTERVAL Optional For: All systems 

INTERVAL or JOBSTEP Required For: MVT (including M65MP) systems 

JOBSTEP Optional For: MFT and MVT (including M65MP) systems 

These options may be selected only when an interval timer is included in the 
central processing unit. Three levels of interval timer support are specified: 

• Time (TIMER) , which provides the complete facilities of the TIME macro 
instruction (the date and time of day) . 
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• Internal Timing (INTERVAL) # which provides the ability to request, check, 
and cancel time intervals with the STIMER and TTIMER macro instructions 
plus the ability to change the time at midnight. This level of support 
also includes the facilities provided by the TIME macro instruction. 

• Job Step Timing (JOBSTEP) , which provides the ability to time each job 
step and enforce the time limits. This level of support also includes 

the facilities provided by the TIME, STIMER, and TTIMER macro instructions. 
(See "Job Step Timing Option" in this section.) 

How to Use 

If no timing options are specified, then just the time of day is available. 

If the EMULATOR macro instruction is specified, TIMER=INTERVAL or JOBSTEP must 
be specified. 

If system management facilities (SMF) are to be included in an MFT or MVT 
system, TIMER=JOBSTEP must be specified in the SOPRVSOR. 

For MVT and M65MP systems, INTERVAL or JOBSTEP must be specified. The storage 
required is included in the basic fixed requirement. 

An MFT system must have one of the time options selected if the "Timestamp" 
feature of the Generalized Trace Facility and the START/STOP capability of 
the IMDPRDMP service aid EDIT statement are desired. 

Where to Find Information 

Further information about timing options can be found in: 

• Storage requirements — OS Storage Estimates 

• TIMER, STIMER, and TTIMER macro instructions — OS Supervisor Services 
and Macro Instructions 

What to Code When Generating a System 

The following code is required to specify any of these options. 

For MFT: 

SUPRVSOR ...,TIMER= (TIMER ) 

< INTERVAL? 
I JOBSTEP ) 

For MVT, including M65MP: 

SOPRVSOR ...,TIMER= (INTERVAL) 

I JOBSTEP f 
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Time-Sharing Option (TSO) 

Optional For: M65WP and MVT systems 

The time sharing option (TSO) adds general-purpose time sharing to the 
facilities already available through MVT. The option provides a command 
language that can be entered at remote terminals — printer-keyboard and 
keyboard-screen devices connected to telephone or other communications lines 
to a computer. The command language provides the following capabilities and 
facilities: 

• Data management 

• Program development 

• Program execution 

• System control 

How to Use 

The generation of the TSO functions, with the exception of the TSO program 
products, takes place during a complete operating system generation. If you 
desire, the TSO generation process can be divided into two generations with 
certain macro instructions and functions specified in a complete operating 
system generation and the others, at some later date, in a processor generation, 

The following is a list of TSO related generating system data sets and the 
DLIB on which they are located. 
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• SYS1.TCAMMAC — The distribution library for the TCAM system macro 
instructions 

DLIB06 

• SYS1.TS0GEN — The distribution library that contains the macro definitions 
of the TSO system generation macro instructions used during Stage II 

• SYS1.TS0MAC — The distribution library for TSO system macro instructions 

• SYS1.CI555 — The component library for TSO modules 

• SYS1 .DCMDLIB — The distribution library for the TSO command library data 
set 

• SYS1.DUADS — The distribution library with the initial TSO user attributes 

• SYS1.DHELP — The distribution library for the TSO HELP data set 
DLIB03 

• SYS1.CQ54 8 — The component library for TCAM modules 

Where to Find Information 

Further information about TSO can be found in: 

• System configuration — OS TSO Guide 
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Storage requirements — OS Storage Estimates 

TCAM information — OS TCAM 

TSO commands — OS TSO Command Language Reference 

TSO data sets — OS System Generation, OS TSO Command Language Reference 

TSO facilities — OS TSO Guide 

What to Code When Generating a System 

The following is a list and description of the required and optional TSO data 
sets for a new TSO system: 

• SYS1.CMDLIB — The TSO command processing programs reside in this data 
set. 

• SYS 1. HELP — The TSO HELP function with a member for each TSO command 
resides in this data set. 

• SYS1.UADS — This data set will contain attribute entries for each 
authorized TSO user. 

• SYS1 . BRODCAST — This data set will store two types of TSO messages. 
Notices - messages available for all users of the system 

Mail - messages available for specific users of the system 

The following code is required to include TSO in the new system: 

GENTSO 

This macro instruction is used in place of the GENERATE macro instruction. 
See "System Generation Macro Instructions" for a discussion of GENTSO: 

CMDLIB 

EDIT BLOCK= (name-n[ f name-n]. . .) 

OUTPUT CLASS= ([ classnamel ][ ,classname2 ]) 

SCHEDULR .. .,OPTIONS=(TSO) , T SUBMITQ=maxno ] 

TELCMLIB [UNIT=name] 

[ VOLNO=serial] 

TSOPTION [LOGTIME=time] 

[ LOGLINE=integer ] 
[ BCLMT=integer ] 

UADS [UNIT=name] 

[ VOLNO=serial] 

To include the HELP function: 

HELP [UNIT=name] 

[ VOLNO=serial] 

To include syntax checking: 

CHECKER ... 
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Time-Slicing 

Optional For: All systems 

When time-slicing is included in the system, you can establish a group of 
partitions or tasks (called a time-slice group) that are to share the use of 
the CPU, each for the same fixed interval of time. For MFT systems, this is 
done for jobs scheduled into a group of consecutive partitions that have been 
defined as the partitions to be used for time-slicing. 

The priority of a job can be changed by the CHAP macro instruction so that 
its priority will fall within the range of the priorities for the partitions 
defined for time-slicing. This job will then be handled in the same manner 
as the other jobs in the time-slice group. For MVT systems, this is done for 
all tasks that have a given priority. 

When a member of the time-slice group has been active for the fixed interval 
of time, it is interrupted and control is given to another member of the group, 
which will, in turn, have control of the CPU for the same length of time. 
In this way, all member tasks are given an egual slice of CPU time and no task 
or partition within the group can monopolize the CPU. In MVT, only tasks in 
the group are time-sliced, and they are time-sliced only when the priority 
level of the group is the highest priority level that has a task ready. 
Dispatching of tasks continues within the group until: 

• All tasks are in a waiting state, or 

• A task of higher priority than the one assigned to the group becomes ready. 

In MFT, only partitions that are assigned to the time-slice group will be time- 
sliced, and they are time-sliced only when the first partition in the group 
is the highest priority ready task. Dispatching of the partitions continues 
within the group until all the partitions are in a waiting state, or until 
a partition with a higher priority is in a ready state. 

How to Use 

The group of tasks to be time-sliced (selected by priority or partition range) 
and the length of the time-slice are specified at system generation time in 
the CTRLPROG macro instruction. This can be modified in MVT at system 
initialization time and in MFT through the DEFINE command. Any task or 
partition in the system that is not defined within the time-slice group is 
dispatched under the current priority structure; that is, the task or partition 
is dispatched only when it is the highest priority ready task or partition 
on the TCB gueue. The maximum number of milliseconds, a number specified from 
a range of 20 to 9999, is the amount of time that each ready task is to have 
control of the CPU during one pass through the group. 

For MVT (including M65MP) systems, any of the priorities, to 13, can be used. 
Where to Find Information 

Further information on time-slicing can be found in: 

• Storage requirements — OS Storage Estimates 

• Detailed description of use — OS MFT Guide, OS MVT Guide 

• System generation macro instructions — OS System Generation 
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• Operator commands — OS Operator's Reference 

• CHAP macro instruction -- OS MFT Guide, OS MVT Guide, OS Supervisor Services 
and Macro Instructions 

What to Code When Generating a System 

The following coding is required to specify this option: 

For MFT — CTRLPROG . . . r TMSLICE= (Pn-Pra, SLC-time) 

For MVT or M65MP — CTRLPROG ... r TMSLICE= (priority, SLC-time 

[ , priority, SLC-time ]. . . ) 



Trace Option 

Optional For: All systems 

A tracing routine that aids in debugging and maintenance can be added to the 
new system. 

The trace option and the generalized trace facility (GTF) component of the 
control program can coexist in the same system, however the trace option 
functions are inhibited while GTF is active. 

How to Dse 

The tracing routine stores information pertaining to start I/O (SIO) instruction 
execution, supervisor (SVC) interruptions, external interruptions, program 
check interruptions, and I/O interruptions in the trace table. When the table 
has been completely filled, the succeeding entries overlay the existing ones. 

During system generation, only the size of the table is specified. However, 
when this system generation parameter is specified, the trace program routines 
are also included as part of the control program. 

Where to Find Information 

Further information about the trace option can be found in: 
Storage requirements — OS Storage Estimates 

Trace table size -- OS System Generation, OS Storage Estimates 
Description — OS MFT Guide, OS MVT Guide 
Trace routine — OS MFT Guide, OS MVT Guide 

SIO, I/O, and SVC interruptions — OS Principles of Operation 
Entry format — OS MFT Guide, OS MVT Guide 
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What to Code When Generating a System 

The following code is required to specify the number of entries in the table, 
which will also include the routines in the control program. 

SOPRVSOR. . . ,TRACE=number 



Transient SVC Table Made Resident 

Standard For: MVT (including M65MP) systems 

Optional For: MFT systems 

The relative track address (TTR) of all transient supervisor (SVC) routines 
are included as part of the resident table of control program SVC routines. 
(See the description in "Types 3 and 4 SVC Routines Hade Resident" in a 
succeeding section.) 

How to Use 

If types 3 and 4 SVC routines are being made resident, this option must be 
specified also. 

During a nucleus generation, this option can be added to or deleted from the 
options specified during a complete operating system generation. 

Where to Find Information 

Further information about the transient SVC table being made resident can be 
found in: 

• Amount of "storage required — OS Storage Estimates 

• How to use the tracing routine — OS MFT Guide, OS MVT Guide 

What to Code When Generating a System 

The following code is required in order to specify this option: 

SOPRVSOR ...,OPTIONS=(TRSVCTBL) 
If types 3 and 4 SVC routines are also to be made resident: 

SUPRVSOR ... ,RESIDNT=(TRSVC) ,OPTIONS= (TRSVCTBL) 

Type 3 and 4 SVC Routines Made Resident 

Optional For: All systems 

Modules of types 3 and 4 supervisor (SVC) routines can be made permanently 
resident in the fixed area of storage. 
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How to Dse 

Types 3 and 4 SVC modules are loaded and made resident at IPL time. When this 
option is specified, the transient SVC table option must also be specified. 
The SVC table is a table containing the relative track addresses of all 
transient SVCs. This table is also stored in the resident portion of the 
control program. 

The names and sizes of types 3 and 4 SVC routine modules are given in OS Storage 
Estimates. (See also the preceding description "Transient SVC Table Made 
Resident. ") 

During a nucleus generation, this option can be added or deleted from the 
options specified during a complete operating system generation, but the 
transient SVC table option will have to be specified the same way it was 
specified in the last complete operating system generation. 

Where to Find Information 

Further information about Types 3 and 4 SVC routines being made resident can 
be found in: 

• Storage reguirements — OS Storage Estimates 

What to Code When Generating a System 

The following code is reguired in order to specify this option: 
SOPRVSOR . . . ,RESIDNT= (TRSVC) ,OPTIONS= (TRSVCTBL) 



User-Added SVC Routines 

Optional For: All systems 

User-written supervisor (SVC) routines can be added to the control program. 

How to Use 

All of the SVC routines, whether they are to be transient or resident, must 
be listed in the operand of the SVCTABLE system generation macro instruction. 

Any resident SVC routines that are to be added must be specified in the system 
generation RESMODS macro instruction. The fixed storage reguirement is 
increased by the total of the sizes of the routines that are going to be added 
plus the size of the control information. 

Any transient SVC routines that are to be added must be specified in the SVCLIB 
system generation macro instruction in the operand. In this case, only the 
size of the control information is added to the fixed storage reguirements. 

Nonstandard error routines can be one of the types of routines that are added. 
User-written routines must have a value from 220 to 229. This value is the 
suffix of the name IGE00 by which the error routine is named in SYS1. SVCLIB. 
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Where to Find Information 

Further information about user-added SVC routines can be found in: 
• SVC routines, writing — OS MFT Guide, OS MVT Guide 

What to Code When Generating a System 

The following code is reguired in order to specify this option: 

SVCTABLE operand[ , operand ].. . 

RESMODS PDS=SYS1.name,MEMBERS=(name[ ,name]. . .) 

SVCLIB PDS=SY51.name # MEMBERS= (name[ ,name ]. . .) 

If nonstandard error routines are specified, the following must also be coded: 

IODEVICE . . . , ERRTAB=nnn 



Validity Check Option 

Standard For: HVT (including M65MP) systems 

Optional For: MFT systems 

Extra validity checking can be added to the new system to determine whether 
addresses are located within proper boundaries. The validity checking is 
provided for the WAIT, POST, and GETMAIN/FREEMAIN modules. The checking for 
WAIT also checks for the number of events. 

How to Use 

For MFT systems, this option is specified in the SUPRVS.OR system generation 
macro instruction. For MVT or M65MP systems, this option is a standard feature 
and the storage reguired is included in their basic fixed reguirement. 

During a nucleus generation, this option can be added to or deleted from the 
options specified during a complete operating system generation. 

Where to Find Information 

Further information about the validity check option can be found in: 
• Amount of storage reguired — OS Storage Estimates 

What to Code When Generating a System 

The following code is reguired in order to specify this option by itself: 
SOPRVSOR ...,OPTIONS=(VALIDCHK) 
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Volume Statistics Facility 

Optional For: All systems 

Volume statistics may be kept only for magnetic tape volumes with or without 
labels. There are two types, either or both of which can be specified at 
system generation time in the SCHEDULR macro instruction. 

Error statistics by volume (ESV) is intended primarily to be used with labeled 
volumes, but will handle an unlabeled volume if the serial number is given 
to the operating system. Statistics about the number of read or write errors 
and the system and unit on which the volume is located are recorded. 

Error volume analysis (EVA) is intended primarily to be used for unlabeled 

or nonstandard labeled volumes. It monitors the number of read or write errors 

based on the limits provided at system generation time. 

These options can be specified for all types of control programs. 

How to Qse 

Error statistics by volume (ESV) collects a set of statistics for each labeled 
tape volume whenever the volume is open. An unlabeled tape volume can be 
handled if the serial number has been supplied to the operating system. 

If ESV=SMF is specified at system generation time, the statistics are 
accumulated on the system management facility (SMF) data sets SYS 1. MANX and 
SYS1.MANY. ACCTRTN^SMF should be specified in the SCHEDULR macro instruction, 
but if it is not coded, it is assumed. If any subparameter for ACCTRTN other 
than SMF is specified, it is ignored and SMF is assumed. The TIMER keyword 
parameter is also reguired in the SOPRVSOR macro instruction. The IFHSTATR 
utility program is used to print the ESV records, record 21, from an SMF data 
set on magnetic tape. If SYS1.MANX is on tape, no transfer is reguired, but 
if the SMF data sets are on a direct-access device, you must dump them onto 
tape in order to be able to extract the ESV records. The SMF dump program, 
IFASMFDP, is used to transfer the data from SYS1.MANX and SYS1.MANY to tape. 

If ESV=CON is specified or if ESV is not coded, an abridged version of the 
statistics is printed on the console. This occurs at end-of-volume or when 
the tape volume is closed. 

Error volume analysis (EVA) acts as a monitor about the number of read and 
write errors for unlabeled or nonstandard labeled tape volumes. You provide 
the maximum limits for read errors and/or write errors and, if the maximum 
is reached or exceeded, a message, IEA620I, is printed on the console. 
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Where to Find Information 

Further information about volume statistics functions can be found in: 

• SVC routines, writing — OS MFT Guide, OS MVT Guide 

• System management facility (SMF) — OS SMF, OS System Generation 

• SMF data sets — OS System Generation, OS SMF 

• Tape labels — OS Tape Labels 

• Storage reguirements — OS Storage Estimates 

• IFASMFDP utility program — OS SM? 

• IFHSTATR utility program — OS Utilities 

What to code When Generating a System 

The following code is reguired to have the error recording routines included 
in the system: 

SCHEDULR ..., [ESV=/cONl] 

I SMF I 
[,EVA=(n*,n2) ] 

For MFT and MVT (including M65MP) if ESV=SMF then: 

SCHEDULR ...,ESV=SMF, 
ACCTRTN^SMF 

SUPRVSOR . . . , TIMES* JOBSTEP 
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Data Sets 



This section contains the detailed information about the required and optional 
data sets for the generating operating system and the new or modified operating 
system. The contents and special notes, such as the need for cataloging and 
release level, are discussed for each required data set in the generating 
system. A table, listing the components, the distribution data sets, whether 
they are required or optional, and where they are placed, is also included. 

The contents, type, specification considerations, and special notes are 
discussed for each system data set in the new or modified operating system. 
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Required and Optional Data Sets for Generating Systems 

This section contains detailed information about the required and optional 
data sets for the generating operating system. 
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SYS1.GENLIB 



Contents 



This data set is required in any generating 
system. 

This data set contains the macro definitions of 
the system generation macro instructions used 
during Stage I. 



Special Notes 



Cataloging: 

This data set must be cataloged in the system 
catalog of the operating system being used as 
the generating system. 

Release Level: 

This data set, SYS1.M0DGEN, SYS 1 .HODGEN2, SYS1.TS0GEN, 
and the various component libraries must all be of 
the same release level. They can be used only 
to generate an operating system of the same 
release level as themselves. 

If the generating system is release 18 or 
earlier, the following must be performed 
before beginning Stage II: 

• Copy the IEBCOPY utility program from 
SYS1.LINKLIB in the starter operating 
system to SYS1.LINKLIB in the generation 
system. 

• Copy the module named IGG019C8 from 
SYS1.SVCLIB in the starter operating 
system to SYS1.SVCLIB in the generating 
system. 
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SYS1.MODGEN, SYS1.MODGEN2 

These data sets are required in any generating 
system. 

Contents These data sets contain the macro definitions of 

the system generation macro instructions used 
during Stage II assemblies. 

Special Notes Cataloging: 

These data sets must be cataloged in the system 
catalog of the operating system being used as 
the generating system. 

Release Level; 

These data sets, SYS1.GENLIB, SYS1.TS0GEN, and 
the various component libraries must all be of 
the same release level. They can be used only 
to generate an operating system of the same 
release level as themselves. 

If the generating system is not release 20, you 
must use Assembler F from the release 20 
distribution package. 
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SYS1.TSOGEN 



Contents 



Special Notes 



This data set is required in any generating 
system that includes TSO. 

This library contains the lacro definitions of 
the TSO system generation macro instructions 
used during Stage II assemblies. 

Cataloging; 

This data set must be cataloged in the system 
catalog of the operating system being used as 
the generating system. 

Release Level: 

This data set, SYS1.GENLIB, SYS1.MODGEN, SYS1. MODGEN2, 
and the various component libraries must all be of 
the same release level. They can be used only 
to generate an operating system of the same 
release level as themselves. 

If the generating system is not release 20, 
you must run Assembler F from the release 20 
distribution package. 
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Component Data Sets 



Contents 



Some or all of these data sets can be selected. 

The members of these data sets are the load 
modules from which the components of an 
operating system are generated. 



Special Note 



Reguired Use: 

The following table shows the names of all the 
components that can be included in an operating 
system, and the data set from which the system 
generation program will take them. Also 
indicated is where the component will be found 
in the new or modified system. If "Optional" 
is indicated in the "Reguired" column, the 
component library data set need only be 
cataloged in the generating system when the 
component is to be generated in the new system. 
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Component 

ALGOL 

ALGOL Library 

American National 
Standard COBOL 

American National 
Standard COBOL 
Library 

Assembler F 

BDAM 

BTAM 

COBOL E 

COBOL E Library 

Control Program 



Conversational 
Remote Job Entry 

Data Management 
(primary routines) 



Data Set Utilities 
Emulators Integrated 

FORTRAN G 
FORTRAN H 
FORTRAN Library 



FORTRAN Syntax 
Checker 

Generalized Trace 
Facility 

Graphic 

Job Processor 



Component Libraries 

Obtained From: Required: 

SYS1.AL531 Optional 

SYS1.LM532 Optional 

SYS1.CB545 Optional 



SYS1.LM546 

SYS1.AS037 
SYS1. DM509 

SYS1.CQ513 

SYS1.CO503 

SYS1.COBLIB 

SYS1.CI505 

SYS1.RC551 
SYS1. DM508 

SYS1.0T506 
SYS1.CI505 

SYS1.FO520 

SYS1.FO500 

SYS1.LM501 
SYS1.FORTLTB 

SYS1.FO550 



SYS1.CI505 
SYS1.CI535 

SYS1.RC541 



Optional 

Optional 
Optional 

Optional 

Optional 
Optional 
Required* 

Optional 
Required* 

Required* 
Optional 

Optional 
Optional 
Optional 

Optional 

Required 

Optional 



Placed In: 
SYS1.LINKLIB 
SYS1.ALGLIB 
SYS1.LINKLIB 

SYS1.COBLIB 

SYS1.LINKLIB 

SYS1.SVCLIB 
SYS1. NUCLEUS 

SYS1.SVCLIB 
SYS1. NUCLEUS 
SYS1.TELCMLIB 

SYS1.LINKLIB 

SYS1.COBLIB 

SYS 1. NUCLEUS 

SYS1.SVCLIB 

SYS1.LINKLIB 

SYS1.LINKL 
SYS1.TELCMLIB 

SYS1.LINKLIB 
SYS 1. NUCLEUS 
SYS1.SVCLIB 

SYS1.LINKLIB 

SYS1.SVCLIB 
SYS 1. NUCLEUS 

SYS1.LINKLIB 

SYS1.LINKLIB 

SYS1.FORTLIB 

SYS1.LINKLIB 



SYS1.LINKLIB 
SYS1. NUCLEUS 

SYS1.SVCLIB 
SYS1.LINKLIB 



Figure 76 (Part 1 of 3) . Components and Generating System Data Sets 
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Component 



Graphic Programming 
Services 



Graphic Subroutine 
Package 



Component Libraries 
Obtained From: Required: 
SYS1. 10523 Optional 



SYS1.LM537 



Optional 



Placed In: 

SYS1.LINKLIB 
SYS1.SVCLTB 
SYS1. NUCLEUS 

SYS1.LINKLIB 
SYS1.F0RTLIB 
SYS 1. PL 1 LIB 
SYS1.C0BLIB 



ISAM 


SYS1. 10526 


Optional 


SYS1.SVCLIB 
SYS 1. NUCLEUS 


Linkage Editor F 


SYS1.ED521 


Optional 


SYS1.LINKLIB 


Loader Program 


SYS1.LD547 


Optional 


SYS1.LINKLIB 


Macro Library 


SYS1.MACLIB 
SYS1.TS0MAC 
SYS1.TCAMMAC 


Required 
Optional 
Optional 


SYS1.MACLIB 


Multiple Console 
Support 


SYS1.CI505 
SYS1.CI535 
SYS1.CQ513 


Optional 


SYS1. NUCLEUS 

SYS1.SVCLIB 

SYS1.LINKLIB 


MVT and M65MP 


SYS1.CI535 


Optional 


SYS 1. NUCLEUS 

SYS1.SVCLIB 

SYS1.LINKLIB 


Online Test 
Executive Program 


SYS1.DN533 


Optional 


SYS1.SVCLIB 
SYS1.LINKLIB 
SYS1. NUCLEUS 


Parameter Library 


SYS1.PARMLIB 


Required 


SYS1.PARMLIB 


PL/1 


SYS1.NL511 


Optional 


SYS1.LINKLIB 


PL/1 Library 


SYS1.LM512 
SYS1.PL1LIB 


Optional 


SYS1.PL1LIB 
SYS1.LINKLIB 


PL/1 Syntax 
Checker 


SYS1.PL552 


Optional 


SYS1.LINKLIB 



Figure 76 (Part 2 of 3) . Components and Generating System Data Sets 
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Component 

Procedure Library 
QTAM 

Recovery Management 
Remote Job Entry 

RPG 

Satellite Graphic 
Job Processor 

SER 

Service Aids 

Sort/Merge 
Sort Library 



System/360- 1130 
Data Transmission 

TCAM 



Telecommunications 
Library 



TSO 



Component Libraries 
Obtained From: Required: 
SYS1.PROCLIB Required 
SYS1.CQ519 Optional 



SYS1.DN539 

SYS1.RC536 

SYS1.RG038 
SYS1.RC543 

SYS1.DN527 

SYS1.DN554 
SYS1.MACLIB 

SYS1.SM023 

SYS1.SORTLIB 
SYS1.SM023 

SYS1.LM542 
SYS1.CQ548 



SYS1.RC536 
SYS1.CQ513 
SYS1.CQ519 
SYS1-CQ548 

SYS1.CI555 



SYS1.TSOGEN 
SYS1.DUADS 
SYS1.DHELP 
SYS1.DCMDLIB 



Required 1 

Optional 

Optional 
Optional 

Required 1 

Optional 

Optional 
Optional 

Optional 

Optional 

Optional 

Optional 



Optional 
Optional 
Optional 
Optional 



Placed In: 

SYS1.PROCLIB 

SYS1.TELCMLIB 
SYS1. NUCLEUS 
SYS1.SVCLIB 

SYS1.LINKLIB 
SYS1.SVCLIB 

SYS1.LINKLIB 
SYS1.TELCMLIB 

SYS1.LINKLIB 

SYS1.LINKLIB 

SYS1.LINKLIB 
SYS1. NUCLEUS 

SYS1.LINKLIB 
SYS1.MACLIB 

SYS1.LINKLIB 

SYS1.SORTLIB 



SYS1.LINKLIB 
SYS1.FORTLIB 

SYS1.SVCLIB 
SYS1.LINKLIB 
SYS1. NUCLEUS 
SYS1.TELCMLIB 

SYS1.TELCMLIB 



SYS1.LINKLIB 
SYS1.SVCLIB 
SYS 1. NUCLEUS 

SYS1.UADS 
SYS1.HELP 
SYS1.CMDLIB 



iNot required for Processor/Library generation 



Figure 76 (Part 3 of 3) . Components and Generating System Data Sets 
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System Data Sets 

This part of the section contains detailed information about all the system 
data sets that can be specified for a new or modified operating system during 
system generation. These data set descriptions are arranged in alphabetical 
order by the fully qualified data set names. The following information is 
supplied for each of the data sets: 

• Whether the data set is required or optional 

• What the data set contains 

• Whether the data set is sequential or partitioned 

• What you must know when you are specifying the data set for the new or 
modified system 

In some cases, special notes about the use of the data set are provided. 
Figure 77 is a summary of the system data sets. 
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System Data Set 


Required 


Type 


SYSCTLG 


Yes 


Seg. 


SYS1.NDCLE0S 


Yes 


PDS 


SYS1.SVCLIB* 


Yes 


PDS 


SYS1.L0GREC3 


Yes 


Seg. 


SYS1.LINKLIB* 


Yes 


PDS 


SYS1.PARMLIB 


Yes 


PDS 


SYS1.PR0CLIB 


Yes 


PDS 


SYS1.SYSJ0BQE12 


Yes 


Seg. 


SYS1.IMAGELIB 


No 


PDS 


SYS1.MACLIB 


So 


PDS 


SYS1.S0RTLIB 


No 


PDS 


SYS1.ALGLIB 


No 


PDS 


SYS1.C0BLIB 


No 


PDS 


SYS1.F0RTLIB 


No 


PDS 


SYS1.PL1LIB 


No 


PDS 


SYS1.TELCMLIB 


No 


PDS 


SYSl.SYSVLOGX 


No 


Seg. 


SYS1.SYSVLOGY 


No 


Seg. 


SYS1. ROLLOUT" 


No 


Seg. 


SYS1.ASRLIB3 


No 


Seg. 


SYS1.ACCT 


No 


Seg. 


SYS1.HANX 


No 


Seg. 


SYS1.NANY 


No 


Seg. 


SYS1.DCHLIB 


Not 3 


PDS 


SYS1.DDMP» 


No 


Seg. 


SYS1.CHDLIB 


Yes*° 


PDS 


SYS1.HELP 


No 


PDS 


SYS1.DADS 


Yes*e 


PDS 



System 

Residence 

Yes 

Yes 

Yes 

Yes 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Yes 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 



Secondary 

Allocation 

Allowed DCB Subparaaeters 



Yes 

No 

Yes 

No 

Yes 

No 

Yes 

No 

No 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

No 

No 

No 

No 

No 

No 

No 

No 

Yes 

Yes 

Yes 



SYS1.BR0DCAST 



Yes*o 



Direct Optional No 



Cataloged 

None 1 ' ^o 

None Optional 
DSORG=POD,RECFM=0,BLKSIZE=1024z Recommended 

None No 

RECFH=0,BLKSIZE=3625« Yes 

RECFM=F,BLKSIZE=80 Recommended* 
RECFH=FB,LRECL*80,BLKSIZE=3360* Recommended 

None Recommended 

RECFM=U,BLKSIZE=1024* Yes 
RECFM=FB,LRECL=80,BLKSIZE=3360* Recommended 

RECFM=0,BLKSIZE=3625* Recommended 

RECFH=0,BLKSIZE=3625* Recommended 

RECFH=0,BLKSIZE=3625* Recommended 

RECFH=0, BLKSIZE=3625* Recommended 

RECPH=U,BLKSIZE=3625* Recommended 

RECFH=0,BLKSIZE=3625» Recommended 

RBCFM=VB,BLKSIZE=3625» * Yes 

RECFM=?B,BLKSIZE=3625* 7 Yes 

None Yes 

None No 

RECFH=0,BLKSIZE=3625* No 

None Recommended 

None Recommended 

None Yes 

None Recommended 

RECFH=0,BLKSIZE=3625* Recommended 

RECFM=FB,BLKSIZE=3360« Recommended 

DSORG=PO,RECFH=FB,LRECL=80, Recommended 
BLKSIZE=800 

DSORG=DA Recommended 



t 2 

1 3 



Space should be allocated by cylinders. 

BLKSIZE=3072 must be specified if the new system is to have the Machine Check Handler 

for Model 65 (MCH) option. 

Space must not be allocated for this data set by the user as it is allocated and 

cataloged during system generation. 

BLKSIZE=3625 applies if the system data set resides on a 2311. 

BLKSIZE=20483 must be specified for a 2301, BLKSIZE=4892 for a 2303, BLKSIZE=14136 

for a 2305-1, BLKSIZE=1466C for a 2305-2, BLKSIZE=7294 for a 2314, and BLKSIZE=13030 

for a 3330. 

SYS1.PARHLIB must be cataloged if it does not reside on the system-residence volume. 

The value of BLKSIZE must be a multiple of 80 which is less than or egual to 3600 for 

a 2311, 20480 for a 2301, 14080 for a 2305-1, 14640 for a 2305-2. 4880 for a 2303, 

7280 for a 2314, or 12960 for a 3330. 

BLKSIZE must be greater than half the amount of storage allocated for the system log 

buffer by means of the WTLBFRS parameter of the SCHEDOLR macro instruction. 

Space need not be allocated for this data set by the user. 

This data set can only reside on 2311, 2314, 2301, 2302, 2303, 2305, or 3330 direct-access 

devices or on any 2400 or 3400 series magnetic tape drive. 

This data set is reguired in a TSO system. 

Should not be specified. If the DSORG subparameter is specified, the catalog cannot 

be moved or copied by the IEHHOVE utility program. 

SYS1.SYSJOBQE must have a contiguous primary space allocation. 

Reguired only if transient DCH support or PFK command entry is specified. 



Note: If linkage editor F is used in the generating system, the blocksize found in the 
DSCB for the data sets whose record form is specified as (RECFH=0) will be the maximum 
blocksize for the device being used. This is not necessarily the size of the current 
record. 



Figure 77. System Data Sets 
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SYSCTLG 



Contents 



Type 

Specifying for the 
New System 



This data set is required for all operating 
systems. 

This data set contains pointers to all the 
cataloged data sets in an operating system. 

Creation: 

The initial entries are created by the system 
generation program. 

This is a sequential data set. 

Location: 



This data set must be on the system-residence 
volume. 

Only the index (SYS1.) of the system catalog 

must reside on the system-residence volume catalog, 

DP Statement: 

The standard format is used. 

The serial number of the new system-residence 
volume must be specified for this data set. 

Secondary allocations can be specified. 

Catalog Statement: 

This statement must not be coded for this data 
set. 
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SYS1.ACCT 

This data set is required if user-written 
accounting routines are in the system. 

Contents User-written accounting routines store 

accounting information in this data set. 

Type This is a sequential data set. 

Specifying for the Location: 
New system 

This data set must be on a permanently resident 
direct-access volume. It can be on the system- 
residence volume. 

DP Statement: 

Space must be allocated. 

Secondary extents cannot be specified. 

The following DCB subparameters must be 
specified: 

RECFM=0,BLKSIZE= 



3625 


if 


on 


a 


2311 




20483 


if 


on 


a 


2301 




4892 


if 


on 


a 


2303 




14136 


if 


on 


a 


2305- 


•1 


14660 


if 


on 


a 


2305- 


•2 


7294 


if 


on 


a 


2314 




13030 


if 


on 


a 


3330 





Catalog Statement: 

This statement must not be coded for this data 
set. 



Special Notes Two Data Sets: 



You can allocate two SYS1.ACCT data sets as 
long as both are on permanently resident direct- 
access volumes. 

Required: 

This data set must be defined when 
ACCTRTN=BASIC is specified in the SCHEDULR 
macro instruction. 

Blocksize: 

If Linkage Editor F is used in the generating 
system, the blocksize in the DSCB is the 
maximum blocksize for the device being used. 



210 OS System Generation 



SYS1.ALGLIB 

This data set is required when the ALGOL 
compiler is in the system. 

Contents The members of this data set are ALGOL 

subroutines in load module form. 

Type This is a partitioned data set. 

Specifying for the Location: 
New or Modified System 

This data set must be on a direct-access 
volume, which can be the system-residence 
volume. 

DP Statement; 

The standard format is used. 

Secondary allocations can be specified. 

The following DCB subparameters must be 
specified: 

RECFM=U,BLKSIZE= 3625 if on a 2311 

20483 if on a 2301 

4892 if on a 2303 

1«136 if on a 2305-1 

14660 if on a 2305-2 

7294 if on a 2314 

13030 if on a 3330 

Catalog Statement: 

You should catalog this data set. 

Special Note Blocksize: 



If Linkage Editor F is used in the generating 
system, the blocksize in the DSCB is the 
maximum blocksize for the device being used. 
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SYS1.ASRLIB 

This data set is required only if the machine- 
check handler (MCH) is in the system. 

Contents This data set contains the refreshable nucleus 

modules for the machine-check handler routines 
for the S/360 Models 65 and 85 and the 
S/370 Models 155, 158, 165, and 168. 

Type This is a sequential data set. 

Specifying for the Location: 
New System 

This data set must be on the system-residence 
volume. 

Space Allocation and Cataloging: 

The system generation program allocates space 
for and catalogs this data set on the system- 
residence volume during system generation. 

DP Statement: 

This statement must not be coded for this data 
set. 

Catalog Statement: 

This statement must not be coded for this data 
set. 

Special Notes Reinitialization : 

This data set is reinitialized by NIP after 
each IPL. 
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SYS1.BRODCAST 

This data set is required for TSO systems. 
Contents This data set stores two types of TSO messages. 

• Notices - messages available for all users 
of the system. 

• Mail - messages available for specific 
users of the system. 

To facilitate the access of each type of 
message, the data set also contains a Notice 
Directory and a Mail Directory. 

Type This is a direct data set. 

Specifying for the Location: 
New or Modified System 

This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. 

DP Statement: 

The standard format is used. 

Space must be allocated. 

Secondary allocations cannot be specified. 

Catalog Statement: 

This data set should be cataloged. 

Special Notes Initialization: 

After system generation, the first use of the 
data set by: 

• User SEND CP, 

• Operator SEND, 

• Account/SEND interface 

will cause the data set to be formatted and 
initialized. The data set will not be 
reformatted until another system generation 
or until the data set is reallocated. 
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SYS1.CMDLIB 

This data set is required if you want a TSO 
system. 

Contents This data set is a load library for command 

processor programs. 

Type This is a partitioned data set. 

Specifying for the Location: 
New or Modified System 

This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. 

DP Statement; 

The standard format is used. 

Secondary allocations can be specified. 

The following DCB subparameters must be 
specified: 

RECFM=U,BLKSIZE= 3625 if on a 2311 

20483 if on a 2301 

14136 if on a 2305-1 

14660 if on a 2305-2 

4892 if on a 2303 

7294 if on a 2314 

13030 if on a 3330 

Catalog Statement: 

You should catalog this data set. 



214 OS System Generation 



SYS1.COBLIB 

This data set is required if the COBOL compiler 
is in the system. 

Contents The members of this data set are COBOL 

subroutines in load module form. 

Type This is a partitioned data set. 

Specifying for the Location; 
New or Modified System 

This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. 

DP Statement: 

The standard format is used. 

Secondary allocations can be specified. 

The following DCB subparameters must be 
specified: 

RECFM=U,BLKSIZE= 3625 if on a 2311 
20483 if on a 2301 
14136 if on a 2305-1 
14660 if on a 2305-2 
4892 if on a 2303 
7294 if on a 2314 
13030 if on a 3330 

Catalog Statement: 

You should catalog this data set. 

Special Notes Blocksize: 

If Linkage Editor F is used in the generating 
system, the blocksize in the DSCB will be the 
maximum blocksize for the device being used. 

Generating System: 



For COBOL E: SYS1.COBLIB must exist as a 
cataloged partitioned data set in the 
generating system and must be of the same 
release level as the SYS1.GENLIB, SYS1.M0DGEN, 
SYS1 .MODGEN2 and component libraries being used. 

For American National Standard COBOL: The 
SYS1.CB545 and SYS1.LM546 component libraries 
must be cataloged in the generating system. 

User-written Programs: If you want any of your 
own programs in the new or modified 
SYS1.C0BLIB, you must add them after system 
generation is over. Be sure you allocate 
enough additional space in this data set for 
your own programs. 
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SYS1.DCMLIB 



Contents 



Type 



Specifying for the 
New System 



This data set is required if either the transient display 
module function or the programmed-function-keyboard (PFK) 
command entry is specified in the SCHEDULR or SECONSLE 
macro instructions. 

This data set is used to hold portions of the display 
control modules that are not resident in main storage. 

This is a partitioned data set. 

Location: This data set must be on a direct-access volume 
It can be on the system-residence volume. 

DD Statement: Space must be allocated for this data set. 
Secondary allocation cannot be made since the space must 
be contiguous. 

Do not specify any DCB subparameters . 

Catalog Statement: You should catalog this data set. 
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SYS1.DUMP 



Contents 



Type 



Specifying for the 
New System 



Special Motes 



This data set is required if you want a core 
image dump recorded. 

This data set is used to contain one core image 
dump recorded by the ABEND or ABTERM routines. 

This is a sequential data set. 

Location: 



This data set can be on either a direct-access 
volume or a magnetic tape volume. It can be on 
the system-residence volume. 

The volume that contains this data set can be 
on: 

2301 drum 

2302 disk 

2303 drum 

2305-1 FHSF (fixed-head storage facility) 

2305-2 FHSF 

2311 disk 

2314 direct-access storage 

or any 

2400 series magnetic tape unit 

3400 series magnetic tape unit 

3330 direct-access storage 

DD Statement: 

This statement is used only if this data set is on a 
direct- access volume and you choose to allocate space 
in which case you must also write an EOF record as the 
first record in the data set. 

The standard format is used. 

Secondary allocations cannot be specified. 

If you do not allocate this data set and it is cataloged, 

NIP will allocate it for you and write the EOF record. 

Catalog Statement: 

Code this statement only if this data set is 
going to be on a direct-access volume. 

Magnetic Tape: 

If this data set is going to be on a magnetic 
tape volume, then it must be specified at IPL 
time. It cannot be cataloged during the 
preparation for system generation. 

Information: 

For further detailed information about core 
image dumps, see OS Programmer's Guide to 
Debugging . 
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SYS1.FORTLIB 



Contents 



Type 

Specifying for the 
New or Modified System 



This data set is optional. 

The members of this data set are FORTRAN 
subprograms in load module form. 

This is a partitioned data set. 

Location; 



This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. 

DD Statement: 



The standard format is used. 

Secondary allocations can be specified. 

The following DCB subparameters must be 
specified: 



Special Notes 



RECFM=0*,BLKSIZE= 


3625 if on a 231 1 




20483 if on a 2301 




4892 if on a 2303 




14136 if on a 2305-1 




14660 if on a 2305-2 




7294 if on a 2314 




13030 if on a 3330 


Catalog Statement: 





You should catalog this data set. 

Blocksize: 

If Linkage Editor F is used in the generating 
system, the blocksize in the DSCB is the 
maximum blocksize for the device being used. 

Generating System: 

If you want to transfer your own programs from 
the generating system to the new or modified 
system, catalog the SYS1.FORTLIB with those 
programs in the generating system catalog. If 
there are no such programs to transfer, catalog 
only the appropriate component libraries in the 
generating system. 
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SYS1.HELP 

This data set is optional for TSO systems. It 
is required if the TSO HELP command is to be 
used. 

Contents Each member of this data set contains TSO HELP 

information regarding the syntax, operands, and 
functions for each TSO command. 

Type This is a partitioned data set* 

Specifying for the Location: 
New or Modified System 

This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. 

DP Statement: 

The standard format is used. 

Secondary allocations can be specified. 

The following DCB subparameters must be 
specified: 

RECFM=FB,LRECL=80, 

BLKSIZE- a multiple of 80, less than or 
equal to: 

80 if unblocked 
3600 for a 2301 
20480 for a 2301 
4880 for a 2303 
14080 for a 2305-1 
14640 for a 2305-2 

7280 for a 2314 
12960 for a 3330 

Catalog Statement: 



You should catalog this data set. 

Special Note Information: 

For further information on this data set, see 
OS TSO Command Language. 
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SYS1.IMA6ELIB 



Contents 



Type 



Specifying for the 
New System 



This data set is required if a 1403 printer 
with the universal character set CUNVCHSET) 
feature, a 3211 printer, or a 3505/3525 card 
read punch is in the system. 

This data set contains the universal character 
set (UCS) and forms control buffers (FCB) image 
modules . 

This is a partitioned data set. 

Location: 

This data set must be permanently mounted on a 
direct-access volume. It can be on the new 
system-residence volume. 

DP Statement: 

Space must be allocated. 

No secondary allocation is allowed. 

The following DCB subparameters must be 
specified: 

RECFM=U,BLKSIZE=1024 

3072 if 
MCH is specified for the Hodel 65. 



Catalog Statement: 

This data set must be cataloged if it is 
to be used. 



Special Note 



Blocksize; 



If Linkage Editor F is used in the generating 
system, the blocksize in the DSCB is the 
maximum blocksize for the device being used. 
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SYS1.LINKLIB 



Contents 



This data set is required in all operating 
systems. 

The members of this data set are programs and 

routines that are referred to by XCTL, ATTACH, 

LINK, or LOAD macro instructions. Nonresident 

operating system programs, such as the COBOL 

compiler, are contained in this data set. The 

S/360 Model 85 Machine-Check Handler Nucleus (IGFMCHIO) 

and Initialization (IGFMCHFO) modules and S/370 

Machine-Check Handler Nucleus 

(IGFMCHEO) and Initialization (IGFMCHFO) 

modules are also included. 



Type 



This data set must contain an 
assembler-language processor with an alias of 
ASMBLE and linkage editor with an alias of 
IEWL. It must also include the utilities 
IEBCOPY, IEHLIST, IEHPROGM, IEHIOSUP, 
IEBQPDTE, and the IFCEREPO (EREP) and 
IFCDIPOO programs. 

This is a partitioned data set. 



Specifying for the Location; 
New or Modified System 



This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. 

DP Statement: 

Space should be allocated in cylinders. For 
maximum efficiency, alternate tracks should not 
be used. 

Secondary allocations can be specified. 

The following DCB subparameters must be 
specified: 



RECFM=0,BLKSIZE= 



3625 if on 2311 

20483 if on 2301 

4892 if on 2303 

14136 if on 2305-1 

14660 if on 2305-2 

7294 if on 2314 

13030 if on 3330 



Catalog Statement: 

This data set must be cataloged in the system 
catalog (SYSCTLG) . 
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Special Notes Concatenation: 



After system generation, up to sixteen data 
sets composed of up to sixteen extents each can 
be concatenated to this data set. The link 
library list LNKLSTOO in SYS1.PAEMLIB must be 
modified. The IEBTJPDTE utility program can be 
used. 

IEBOPDAT; 

If this system utility program is to be 
link-edited into this data set, you must 
allocate additional space for the utility 
program. See the "Including IEBUPDAT in the 
New System" section. 

Blocksize; 

If Linkage Editor F is used in the generating 
system, the blocksize in the DSCB for the data set 
whose record form is specified as U (RECFM=U) will 
be the maximum blocksize for the device being used. 
This is not necessarily the size of the current 
record. 
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SYS1.LOGREC 



Contents 



Type 



Specifying for the 
Hew System 



Special Notes 



This data set is required in all operating 
systems. 

This data set is used to record statistical 
data about machine errors that is used by 
the IBM customer engineer. 

This is a sequential data set. 

Location: 



The system generation program initializes and 
allocates space for this data set on the system- 
residence volume . 

This data set must be on the system-residence 
volume. 

DP Statement: 

This statement must not be coded for this data 
set. 

Catalog Statement: 



This statement must not be coded for this data 
set. 

Reinitialization: 

If this data set must be reinitialized after 
system generation, refer to the description of 
the IFCDIPOO utility program in OS Service Aids. 



Reallocation: 

The size of this data set can be increased or decreased 
after system generation by using IFCDIPOO to reallocate 
it. Refer to the publication OS Service Aids for a 
description of IFCDIPOO. 

Message: 

A message is printed out during Stage II that 
provides information about this data set. 
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SYS1.MACLIB 

This data set is optional in the new or 
modified system, but is required in the 
generating system. 

Contents The members of this data set are the macro 

definitions for the system macro instructions 
used by the assembler- language processor. 

Type This is a partitioned data set. 

Specifying for the Location: 
New or Modified System 

This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. 

DP Statement; 

The standard format is used. 

Secondary allocations can be specified. 

The following DCB subparameters must be 
specified: 

RECFM=FB, LRECL=80 , 

BLKSIZE* 3360 or a multiple of 80, which is 
less than r or equal to: 
80 if unblocked 
3600 for a 2311 



20480 


for 


a 


2301 


14080 


for 


a 


2305-1 


14640 


for 


a 


2305-2 


7280 


for 


a 


2314 


12960 


for 


a 


3330 



Catalog Statement: 

You should catalog this data set. 

Special Notes Generating System: 

This data set must be of the same release level 
as SYS1.GENLIB, SYS1.MODGEN, SYS 1. H0DGEN2, 
SYS1.TSOGEN, and the component libraries being 
used. 

If Assembler E is used in the generating 
system, this data set must be unblocked. This 
can be done by IEBCOPY if you specify in the 
SYSUT2 DD statement: 

DCB-(RECFM=FB,BLKSIZE=80,LRECL=80) 
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SYS1.MANX, SYS1.MANY 



Contents 



Type 



Specifying for the 
New System 



Special Note 



One or both of these data sets must be 
specified if the system management facility is 
in the system. 

One or both of these data sets contain the data 
collected by the system management facility 
(SHF) routines. 

These are sequential data sets. 

Location; 

If a direct-access device is used, then both 
data sets must be defined. If magnetic tape is 
used, only SYS1.HANX can be defined. 

One or both must reside on a permanently 
resident volume. It can be the system- 
residence volume. 

DP Statement; 

The standard format is used. 

Secondary allocations, if they are coded, are 
ignored. 

Catalog Statement; 

Tou should catalog these data sets. 

Magnetic Tape; 

If magnetic tape is used, only one data set 
(SYS 1. MANX) can be defined, but up to 20 
volumes can be used each time the system is 
loaded. 
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SYS1.NUCLEUS 

This data set is required in all operating 
systems. 

Contents This data set usually contains only one member, 

the resident portion (nucleus) of the control 
program. 

Type This is a partitioned data set. 

Specifying for the Location; 
New or Modified System 

This data set must be on the system-residence 
volume. 

DP Statement: 

The standard format is used. 

The serial number of the new system-residence 
volume must be specified for this data set. 

There cannot be any secondary allocations. 

Catalog Statement: 

You should catalog this data set. 
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SYS1.PARMLIB 



Contents 



This data set is required in all operating 
systems. 

The members of the parameter library are the 
RAM, BLDL, RSVC, and SHFDFLT system parameter 
lists used by the nucleus initialization 
program (NIP) , the PRESRES list used by the 
master scheduler, and the LNKSTOO list used to 
concatenate data sets to SYS 1.LINKLIB. If SYS1.PARMLIB 
is copied from the starter operating system, it will 
contain the standard RAM list (IEAIGGOO) and the optional 
RAM list (IEAIGG01) , 



Type 

Specifying for the 
New System 



This is a partitioned data set. 
Location: 



This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. 

DP Statement: 

Space must be allocated for this data set 
except when the standard IBM parameter list is 
not going to be used. In the latter case, a 
null allocation must be made. 

Secondary allocations cannot be made because 
the space must be continuous. 

The following DCB subparameters must be 
specified: 

RECFM=F,BLKSIZE=80 

Catalog Statement: 

This data set must be cataloged if it does not 
reside on the system-residence volume. 

You should always catalog this data set. 
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SYS1.PL1LIB 



Contents 



Type 



Specifying for the 
New or Modified System 



Special Notes 



This data set is required if the PL/I compiler 
is in the system. 

The members of this data set are PL/I 
subprograms in load module form. 

This is a partitioned data set. 

Location: 

This data set must be on a direct-access 
volume. It can be the system-residence volume, 

DP Statement: 

The standard format is used. 

Secondary allocations can be specified. 

The following DCB subparameters must be 
specified: 

RECFM=U,BLKSIZE= 3625 if on a 2311 

20483 if on a 2301 

4892 if on a 2303 

14136 if on a 2305-1 

14660 if on a 2305-2 

7294 if on a 2314 

13030 if on a 3330 

Catalog Statement: 

You should catalog this data set. 

Blocksize: 

If Linkage Editor F is used in the generating 
system, the blocksize in the DSCB is the 
maximum blocksize for the device being used. 



Generating System: 

If this data set is going to be in the new 
system, it must exist as a cataloged 
partitioned data set in the generating systei 
catalog, and be of the same release level as 
SYS1.GENLIB, SYS1.HODGEN, SYS1 . M0DGEN2, and 
the component libraries being used. 
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SYS1.PROCLIB 



Contents 



Type 



Specifying for the 
New System 



This data set is required in all operating 
systems. 

The members of this data set include the 
cataloged procedures used to perform certain 
system functions, such as compile-link-edit-go. 

This is a partitioned data set. 

Location: 



This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. (For KFT and MVT: The SCHEDOLR 
PROCRES keyword parameter should not be 
specified if this data set is cataloged.) 



Special Note 



DP Statement; 

Space must be allocated, 
not permitted. 



A null allocation is 



Secondary allocations can be specified. 

The following DCB subparameters must be 
specified: 

RECFM=FB,LRECL=80, 

BLKSIZE= 3360 or a multiple of 80, which is 
less than, or equal to: 
80 if unblocked 
3600 for a 2311 
20480 for a 2301 
4880 for a 2303 
14080 for a 2305-1 
14640 for a 2305-2 
7280 for a 2314 
12960 for a 3330 

This data set must be blocked if the PROCLIB 
macro instruction is specified during system 
generation. 

Catalog Statement: 

You should catalog this data set. 

SET Command: 

If this data set is cataloged, or if it resides 
on the system-residence volume, you do not have 
to specify the PROC subparameter in the initial 
SET command during IPL for the new system. 
(For detailed information, see OS Operator's 
Reference. ) 
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SYS1.ROLLOUT 



Contents 



Type 



Specifying for the 
New System 



Special Note 



This data set is required if the MVT (including 
M65MP) , rollout/rollin function is specified in 
the CTRLPROG macro instruction. 

This data set is used to hold the information 
rolled out of main storage. 

This is a sequential data set. 

Location: 



This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. 

This data set can only reside on a 2301, 2305-1, 
2305-2, 2311, 2314, 2321, or 3330. 

DP Statement: 

You do not have to specify a space allocation, 
but if you do, it must be one or more tracks. 

The standard format is used. 

Catalog Statement: 

This data set is not used during system 
generation. Therefore, it does not have to be 
allocated and cataloged until just before IPL 
for the new system. For convenience, it is 
recommended that you allocate and catalog it 
with the other system data sets. 

IPL Time: 

If you did not allocate space for this data 
set, the nucleus initialization program (NIP) 
will do so. The space will be allocated on the 
volume specified in the DD statement. 

Failure: 

If this data set was not cataloged or if not 
enough space was allocated, the rollout/rollin 
function will not be used. 
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SYS1.SORTLIB 



Contents 



Type 



This data set is required if the sorting and 
merging functions are in the system. 

The members of this data set are the load 
modules from which the system produces a 
sort/merge program at execution time. 

This is a partitioned data set. 



Specifying for the Location: 
New or Modified System 



This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. 

DP Statement: 

The standard format is used. 

Secondary allocations can be specified. 

The following DCB subparameters must be 
specified: 



RECFM=U,BLKSIZE= 



3625 


if 


on 


a 


2311 




20 483 


if 


on 


a 


2301 




4892 


if 


on 


a 


2303 




14136 


if 


on 


a 


2305- 


-1 


14640 


if 


on 


a 


2305- 


•2 


7294 


if 


on 


a 


2314 




13030 


if 


on 


a 


3330 





Special Notes 



Catalog Statement: 

You should catalog this data set. 

Blocksize: 

If Linkage Editor F is used in the generating 
system, the blocksize in the DSCB is the 
maximum blocksize for the device being used. 

Generating System: 

If this data set is going to be in the new 
system, it must exist as a cataloged 
partitioned data set in the generating system 
catalog and be of the same release level as 
SYS1.GENLIB, SYS1.M0DGEN, SYS1 . MODGEN2, and 
the component libraries being used. 
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SYS1.SVCLIB 

This data set is required in all operating 
systems. 

Contents The members of this library are the nonresident 

SVC routines, the data management access 
methods, the system's standard error recovery 
(SER) routines, and the S/360 Model 85 and 
S/370 Machine-Check Handler nonresident 
modules. 

Type This is a partitioned data set. 

Specifying for the Location: 
New or Modified System 

This data set must be on the system-residence 
volume. 

DP Statement; 

The serial number of the new system-residence 
volume must be specified for this data set. 

This data set cannot occupy more than 10 23 
tracks on the system-residence volume. 

Secondary allocations can be specified. 

Space should be allocated in cylinders. For 
maximum efficiency, alternate tracks should not 
be used. 

The following DCB subparameters must be 
specified: 

DSORG=POU,RECFM=0,BLKSIZE= 1024 

3072 if 
MCH is specified for Model 65 

Catalog Statement: 

You should catalog this data set because some 
cataloged procedures use its name to refer to 
the system-residence volume. 

Special Note Blocksize: 

If Linkage Editor F is used in the generating 
system, the blocksize in the DSCB for the data 
set whose record form is specified as U (RECFM=U) 
will be the maximum blocksize for the device 
being used. This is not necessarily the size of 
the current record. 
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SYS1.SYSJOBQE 



Contents 



Type 



Specifying for the 
New System 



Special Notes 



This data set is required in all operating 
systems. 

This data set is used as a work area by the job 
scheduler. 

This is a sequential data set. 

Location: 



This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. The SCHEDULR JOBQRES keyword 
parameter should not be specified if this 
data set is cataloged.) 

DP Statement: 

For maximum efficiency, alternate tracks should 
not be used. 

Space must be allocated for this data set, but 
no more than 1215 tracks can be allocated on a 
2314 and no more than 745 tracks can be 
allocated on a 3330. 

If this data set is date protected, operator 
intervention is required. 

Secondary allocations cannot be specified. 

Catalog Statement: 

You should catalog this data set. 

SET Command: 

If this data set is cataloged, or if it resides 

on the system-residence volume, UNIT need not be 

specified in the job queue parameter during IPL 

when Q is being formatted. 

(For detailed information, see OS Operator's 

Reference., } 

Allocation and Cataloging: 

This data set is not used during system 
generation. Therefore, it does not have to be 
allocated and cataloged until just before IPL 
for the new system. For convenience, it is 
recommended that you allocate and catalog it 
with the other system data sets. 
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SYS1.SYSVLOGX, SYS1.SYSVLOGY 



Contents 



Type 

Specifying for the 
New System 



These data sets are required if you want a 
system log in your system. 

These data sets contain system log data that 
consists of: 

» Write-to-log (WTL) messages 

> Data entered by the operator 

► Job time, step time, and data from the JOB 
and EXEC statements of a job that has ended 

' Write-to-operator (WTO) and 

write-to-operator reply (WTOR) messages 
» Accepted replies to WTOR messages 
» Operator commands 

These are sequential data sets. 

Location: 



These data sets must be on direct-access 
volumes. They can be on the system-residence 
volume. 

DP Statement: 

The standard format is used. 

Secondary allocations cannot be specified. 

The following DCB subparameters must be 
specified: 

RECFM=VB,BLKSIZE= 3625 if on a 2311 

20483 if on a 2301 
4892 if on a 2303 
14136 if on a 2305-1 
14660 if on a 2305-2 
7294 if on a 2314 
13030 if on a 3330 

BLKSIZE must be greater than half the amount of 
storage allocated for the system log buffer by 
means of the WTLBFRS parameter of the SCHEDULR 
macro. 

If the RETPD or EXPDT subparameters of the LABEL 
parameter on the DD card specify an unexpired data 
set, a possible ENQ interlock condition exists between 
COMTASK and LOGTASK. To avoid this possibility, do 
not specify RETPD or EXPDT on the DD card. 

Catalog Statement ; 

This statement must be coded for these data sets. 

Allocation and Cataloging: 

These data sets are not used during system 
generation. Therefore, they do not have to be 
allocated and cataloged until just before IPL 
for the new system. For convenience, it is 
recommended that you allocate and catalog them 
with the other system data sets. 
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SYS1.TELCMLIB 



Contents 



Type 



Specifying for the 
New System 



This data set is required if TCAM, BTAH and/or 
QTAH are in the system. It is also required 
for a TSO system. 

The members of this data set are 
telecommunications subroutines in load module 
form. 

This is a partitioned data set. 

Location: 



This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. 

DP Statement; 

The standard format is used. 

Secondary allocations can be specified. 

The following DCB subparameters must be 
specified: 



RECFM=U,BLKSIZE= 



3625 if on a 2311 

20483 if on a 2301 

4892 if on a 2303 

14136 if on a 2305-1 

14660 if on a 2305-1 

7294 if on a 2314 

13030 if on a 3330 



Special Note 



Catalog Statement: 

Tou should catalog this data set. 

Blocksize: 

If Linkage Editor F is used in the generating 
system, the blocksize in the DSCB will be the 
maximum blocksize for the device being used. 



Data Sets 235 



SYS1.UADS 



This data set is required for TSO systems. 



Contents There are one or more members for each terminal user, 

Basically, the data set is a list of terminal 
users who are authorized to use TSO. It 
contains information about each of them. 

Type This is a partitioned data set. 

Specifying for the Location; 
New or Modified System 

This data set must be on a direct-access 
volume. It can be on the system-residence 
volume. 

DP Statement; 

The standard format is used. 

Secondary allocations can be specified. 

The following DCB subparameters must be 
specified: 

DSORG=PO,LB.ECL=80,BLKSIZE=800,RECFM=FB 

Catalog Statement; 

This data set should be cataloged. 

Special Note Information: 

For further detailed information about this 

data set, see OS 

TSO Command Language. 
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System Generation Macro Instructions 



This section contains the detailed information necessary to select and code 
the system generation macro instructions. 

The conventions used to code the macro instructions, the text format, a summary 
of the macro instructions by group (machine configuration, control program, 
etc.) and type of generation, and a cross-reference table showing the 
dependencies among the macro instructions are included. 

The macro instructions are alphabetically organized for ease of reference. 
& description, requirements, parameters, and coding hints and additional 
information are provided for each macro instruction. 




System Generation Macro Instructions 237 



Conventions 

This section describes the conventions used to code system generation macro 
instructions and the notation used in this publication to describe system 
generation macro instructions. 



CODING MACRO INSTRUCTIONS 

The rules for coding system generation macro instructions are those of the 
assembler language. The following paragraphs are a summary of these rules 
as stated in the publication, OS Assembler Language. 

System generation macro instructions have the following standard format: 

Name Operation Operand 

Symbolic Macro Optional and required parameters 
name instruction 
type 

The name symbolically identifies the macro instruction. If included, it can 
contain from one through eight alphameric characters, the first of which must 
be alphabetic. The name must begin in the first position of the macro 
instruction and must be followed by one or more blanks. Unless otherwise 
indicated in the description of individual macro instructions, the name field 
of a system generation macro instruction is ignored during system generation. 

The operation identifies the macro instruction. It must be preceded and 
followed by one or more blanks. 

The operand contains parameters coded in any order and separated by commas. 
The operand field ends with one or more blanks placed after the last parameter. 
In most system generation macro instructions, keyword parameters are used in 
the operand field. A keyword parameter consists of a keyword followed by an 
equal sign (=) and the keyword value. The keyword value must be a single value 
or a list of values; in the latter case, the values must be separated by commas 
and the list enclosed in parentheses. 

Comments can be written in a system generation macro instruction, but they 
must be separated from the last parameter of the operand field by one or more 
blanks. You can use an entire card for a comment by placing an asterisk in 
the first column. Extensive comments may be written by using a series of cards 
with an asterisk in the first column of each card. A macro instruction that 
has no parameters cannot have comments. 

A typical system generation macro instruction might appear as: 

NAME OPERATION KEY 1=value» , value*) ,KEY3=value, . . . 

System generation macro instructions are coded in columns 1 through 71 of a 
card. A macro instruction that exceeds column 71 can be continued onto one 
or more additional cards; a nonblank character is placed in column 72 to 
indicate continuation. The macro instruction can be interrupted either in 
column 71 or after any comma that separates parameters. The continued portion 
must begin in column 16 of the following card. Comments can be coded through 
column 71, and, if continued, must begin in column 16 of the following card. 
In addition, comments may- appear on every card of a continued statement. 
Columns 73 through 80 can be used to code identification and/or statement 
sequence characters. 
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Describing Macro Instructions 

The following conventions are used in this publication to illustrate the format 
and coding of system generation macro instructions: 

• Uppercase letters, numbers, and punctuation marks must be coded exactly 
as shown. Exceptions to this convention are brackets, [ ]; braces, { }; 
ellipses,...; and subscripts. These are never coded. 

• Lowercase letters and words represent variables for which you must 
substitute specific information or specific values. 

• Items or groups of items within brackets [ ] are optional. They may be 
omitted at the programmer's discretion. Conversely, the lack of brackets 
indicates that an item or group of items must be coded. 



Braces [ } group related items. 

Stacked items enclosed in braces represent alternative items, 
of the stacked items should be coded. 



Only one 



If an alternative item is underlined, the operating system will 
automatically assume it is your choice if none of the items is coded. 

An ellipsis ... indicates that the preceding item or group of items can 
be coded two or more times in succession. 



Macro Instructions Text Format 

The content of the new operating system is specified through system generation 
macro instructions. The macro instructions appear in alphabetical order and 
the description of each follows the format shown in Figure 78. 
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MACRO INSTRUCTION NAME 

A description of the macro instruction, its function, and whether it is required 
or optional is provided. 

Basic Requirements 

All basic requirements for the use of the macro instruction are listed. 

Nucleus Generation 

Additional requirements for usinq the macro instruction durinq a nucleus 
generation, if applicable, are listed. (See Fiqure 79.) 

Processor/Library Generation 

Additional requirements for usinq the macro instruction durinq a 
Processor/Library qeneration, if applicable, are listed. (See Fiqure 79.) 

I/O Device Generation 

Additional requirements for usinq the macro instruction durinq an I/O Device 
qeneration, if applicable, are listed. (See Fiqure 79.) 



Name Operation Operand 

Format of the macro instruction 

Name Field: Description of the name field, if applicable. (See "Codinq Macro 
Instructions" in the "Conventions" section.) 

Operand Field; Each keyword parameter in the operand field is described. 
Any defaults or notes about each keyword parameter and/or its subparameters 
are provided. 

Codinq Hints and Additional Information 

Any additional information that miqht help the system proqrammer is provided. 

Example: One or more examples of valid ways of codinq the macro instruction 
are supplied. These examples are not meant to be recommended ways of codinq 
the macro instruction. They are just intended to illustrate the mechanics 
of codinq a valid combination of parameters. 

NAME OPERATION KEY1= (value 1 , value 2 ) ,KEY3= (value, . . . ) 

Fiqure 78. Format of Macro Instruction Descriptions 
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Macro Instruction Summary 

Not all system generation macro instructions are required for the system 
generation process. Figure 79 lists the system generation macro instructions 
for each type of system generation, indicating whether they are required or 
optional. If neither required nor optional is indicated, that macro instruction 
does not apply to that type of system generation, and the functions it specifies 
are not generated if it is included in the input deck. (The type of syscem 
generation can be specified in the GENERATE macro instruction.) Notes and 
guidelines about the various types of system generation are provided at the 
end of this section following Figure 89, which contains the cross-references 
between the macro instructions. 

Figure 79 also shows which macro instructions can be issued more than once 
during a system generation process. All UNITNAME macro instructions having 
the same NAME, value must appear together in the input deck. Each IOCONTRL 
macro instruction must precede in the input deck to system generation those 
IODEVICE macro instructions that define devices attached to that control unit. 
All other system generation macro instructions, with the exception of GENERATE, 
can be issued in any order. The GENERATE macro instruction must be the last 
macro instruction in the input deck for the system generation process. 

Dependencies among the parameters of a macro instruction are illustrated by 
the macro instruction format and, when necessary, by tables within each macro 
instruction description. Dependencies among macro instructions are stated 
in the descriptions of each macro instruction and summarized at the end of 
this section in Figure 89. 

Several keywords in the system generation macro instructions request the 
specification of the unit name of a device , for example, ONIT=name in the 
FORTLIB macro instruction and RESNAME=name in the GENERATE macro instruction. 
The unit name of a device can be one of the following: 

• Unit address, such as 192. 

• Device types, such as 2311. (Device types are listed in Appendix A.) 

• Group name, or name of a collection of devices, such as TAPE or SYSDA. 
(See UNITNAME macro instruction.) 

It is recommended that device types be used, although all three types are 
equally valid. 
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Type of System 


i Generation 






Macro 


Operating 




Processor/ 




Group 


Instruction 


System 


Nucleus 


Library 


I/O 




CENPROCS 


Required 


Required 


Required 


Required 




CHANNEL 2 


Required 


Required 





Required 


Machine 


I0C0NTRL 2 


Required 


Required 


. — 


Required 


Configuration 


IODEVICE 2 


Required 


Required 





Required 




IMAGELIB 


Optional 




... 


Optional 




DCS 


Optional 


- — 





Optional 




DNITNAHE 2 


Optional 


"-" 


•"-- 


Optional 




CTPLPROG 


Required 


Required 





Required 




SCHEDULR 


Required 


Required 


Optional 


Required 




SUPRVSOR 


Optional 


Optional 


Optional 


Optional 


Control 


CKPTREST 


Optional 











Program 


GJOBCTL 


Optional 


Optional 


-— 


Optional 




PARTITNS 


Optional 


Optional 









SECMODS 


Optional 


Optional 





Optional 




SECONSLE 2 


Optional 


Optional 


... 


Optional 




DATAMGT 


Optional 


Optional 


... 


Optional 


Data 


GRAPHICS 


Optional 


Optional 


Optional 


Optional 


Management 


PTOP 


Optional 


... 


Optional 


... 




TELCMLIB 


Optional 


... 





— . 




LINKLIB 


Optional 





Optional 





User-Hritten 


RESMODS 


Optional 


Optional 


... 


... 


Routines 


SVCLIB 


Optional 





Optional 






SVCTABLE 2 


Optional 


Optional 


- — 


Optional 




ALGOL 


Optional 




Optional 







ALGLIB 


Optional 


— - 


Optional 


— - 




ASSEMBLR 


Optional 





Optional 







MACLIB 


Optional 


... 


Optional 






CHECKER 2 


Optional 


... 


Optional 






CMDLIB 


Optional 


... 


Optional 


.— 




COBOL 2 


Optional 





Optional 







COBLIB 2 


Optional 





Optional 







DCMLIB 


Optional 








Optional 




EDIT 


Optional 




Optional 






EDITOR 2 


Optional 


... 


Optional 






EMULATOR 


Optional 


Optional 


... 


Optional 




FORTRAN 2 


Optional 


... 


Optional 





Processing 


FORTLIB 


Optional 


— - 


Optional 


... 


Programs and 


HELP 


Optional 




Optional 


... 


Libraries 


LOADER 


Optional 





Optional 






OUTPUT 


Optional 


— 


Optional 







PARMLIB 


Optional 


— « 


Optional 


. 




PL1 


Optional 





Optional 






PL 1 LIB 


Optional 


— .*. 


Optional 


... 




PROCLIB 


Optional 


... 


Optional 







RPG 


Optional 


... 


Optional 







SORTMERG 


Optional 





Optional 







SORTLIB 


Optional 


— 


Optional 


... 




SYSUTILS 


Optional 







Optional 




TSOPTION 


Optional 


... 


... 






DADS 


Optional 




Optional 


, 


GENERATE 


GENERATE 1 


Required 


Required 


Required 


Required 




GENTSO 1 


Required 


Required 


Required 


Required 



1 GENTSO is the last system generation macro that can be used if a TSO system is being 
generated or modified. GENERATE is used for all other generations or modifications. 

2 This macro may be specif ied more than once. 

Note : Be sure to read the description of each macro for the type of 
SYSGEN you are doing, as it indicates any special requirements or 
relationships to other macros. 

Figure 79. System Generation Macro Instructions 
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ALGLIB 

The ALGLIB macro instruction specifies the inclusion of the ALGOL subroutine 
library (SYS 1 . ALGLIB) in the new operating system. This macro instruction 
is optional. 

Basic Requirement 

The system data set SYS1. ALGLIB must be allocated space in the new system. 

It may be cataloged in the new system, which can be done during the preparation 

for system generation. 

Processor/Library Generation 

When an existing ALGOL library, SYS 1. ALGLIB, is being replaced, the following 
must be done: 

• The existing library must be scratched and uncataloged before the new one 
can be initialized. 

• The member IHIERROR must be scratched from SYS l.LINKLIB. 

Name Operation Operand 

ALGLIB [UNIT=name 1 
LV0LN0=serialJ 

Default: If no keyword parameters are coded, the system data set SYS 1. ALGLIB 
is placed on the new system-residence volume. 

ONIT= 

specifies a direct-access device that will hold the volume on which the 
ALGOL subroutine library will be generated. 

name 

is the device type. 

Notes: 

• Required: If this keyword parameter is specified, VOLNO must be specified. 

• Device: The direct-access device assigned to hold the new ALGOL library, 
SYS 1. ALGLIB, must be a device that already exists in the generating system. 

VOLNO= 

specifies the serial number of the volume that is to contain the ALGOL 
subroutine library for the new system. 

serial 

is the .serial number. 

Notes: 




Required: If this keyword parameter is specified, UNIT must be specified. 

Serial Number: The one specified must be the same as the one used in the 
VOLUME keyword parameter of the DD statement when space was allocated for 
SYS1. ALGLIB. 
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Coding Hints and Additional Information 

This example illustrates the use of the ALGLIB macro instruction to specify 
the inclusion of the ALGOL subroutine library in the new operating system. 
The unit name is 2301. The volume serial number is 333777. 

ALGLIB UNIT=2301,VOLNO<333777 
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ALGOL 

The ALGOL macro instruction specifies the inclusion of the ALGOL compiler. 
This macro instruction is optional. 

Basic Requirements 

• The ALGLIB macro instruction must be specified. 

• In the CENPROCS macro instruction, INSTSET=SCNTF or INSTSET=UNIV must be 
specified. 

• This macro instruction cannot be specified if HODEL-195 has been specified 
in the CENPROCS macro instruction. 

Processor/Library Generation 

Sufficient space for the ALGOL compiler must be allocated in SYS1.LINKLIB. 

If the ALGOL macro instruction is used to provide a replacement for an existing 
ALGOL compiler, then the following conditions must also exist. 

Members IEX10, IEX11, IEX20, , IEX21, IEX30, IEX40, IEX50, and IEX51 must be 
scratched from SYS1.LINKLIB. (The space that these members occupied can be 
recovered by use of the IEBCOPY utility program.) 



Name 



Operation 
ALGOL 



Operand 

SIZE=size] 
PUNCH* JN0DECK1] 

{deck jj 



TYPERON* 



SORCODE= 



SORLIST= 



fPRECISN- 



LOAD 



NOLOAD 
EBCDIC 



ISO 
SOURCE )] 
[NOSOORCEJJ 
SHORT ]] 



LONG 



All the keyword parameters provide defaults for the various options that can 
affect an ALGOL compilation. These default options will be used if the 
corresponding values are omitted from the PARH field of the EXEC statement 
for the ALGOL compilation. 

PRECISN= 

specifies the internal representation of real values. 




SHORT 



specifies fullwords. 



LONG 



specifies doublewords. 
Default: If this keyword parameter is omitted, SHORT is assumed. 
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PUNCH= 

specifies the production of a punched deck of the object program. 

DECK 

specifies that a punched deck is to be produced. 

NODECK 

specifies that a punched deck is not to be produced. 

Default: If this keyword parameter is omitted, NODECK is assumed. 

SIZE= 

specifies the maximum number of bytes of main storage available to the 
ALGOL compiler. 

size 

is an integer from 45056 to 999999. 

Default; If this keyword parameter is omitted, 45056 is assumed. 

SORCODE= 

specifies the character set used to keypunch the source programs to be 
compiled. 

EBCDIC 

specifies the EBCDIC character set. 

ISO 

specifies the standard 46-character set in BCD established by the 
International Standards Organization (ISO) for ALGOL. 

Default: If this keyword parameter is omitted, EBCDIC is assumed. 

SORLIST= 

specifies the production of a listing of the ALGOL source program and 
identifier table. 

SOURCE 

specifies that the listing is to be produced. 

NOSOURCE 

specifies that the listing is not to be produced. 

Default: If this keyword parameter is omitted, SOURCE is assumed. 

TYPERUN= 

specifies the production of input to the linkage editor from the program 
being compiled. 

LOAD 

specifies that the program is to be processed by the linkage editor 
after compilation. 

NOLOAD 

specifies that the program is only to be compiled. 

Default: If this keyword parameter is omitted, LOAD is assumed. 
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Coding Hints and Additional Information 

This example illustrates the use of the ALGOL macro instruction to specify 
the inclusion of the ALGOL compiler. Unless otherwise specified at compilation 
time, the compiler will use 90112 bytes of main storage and will accept source 
programs written in the standard 46-character set in BCD. A source program 
listing is produced, internal real values are represented in doublewords, and 
compiled source programs are processed by the linkage editor; a punched deck 
is not produced. 

ALGOL SIZE=901 12, PRECISN=LONG, SOSCODE=ISO 
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ASSEMBLR 

The ASSEMBLR macro instruction specifies the inclusion of the assembler language 
processor. This macro instruction is required for the first system generation 
and is optional after that. 

Basic Requirements 

• Each operating system must have an assembler- language processor. 

• For MVT (including M65MP) systems: If IBM-supplied cataloged procedures 
are going to be used and the F128 linkage editor is included in the system, 
the REGION parameter in the cataloged procedures with linkage editor steps 
must be changed. The alias for the linkage editor, IEWL, is given to the 
linkage editor included in the system, unless more than one is specified, 
in which case the alias is given to the largest. To change the parameter, 
use the IEBOPDTE utility program. Information about region sizes is 
provided in OS Storage Estimates. 

• If Assembler E is used for system generations, then SYS1.GENLIB must be 
unblocked. 

Processor/Library Generation 

Sufficient space for the assembler being included must have been allocated 
in SYS1.LINKLIB. 

Name Operation Operand 

ASSEMBLR DESIGN-F 



DESIGN= 

specifies the design level of the assembler-language processor to be 
included in the new system. 

F 

specifies the F-design level. 

Coding Hints and Additional Information 



ASSEMBLR 



When you are using this macro instruction, the following guidelines can be 
helpful. 

• IEOASM is the name of Assembler F. 

• The alias ASMBLR is given to the assembler-language processor in the system. 

Example: The following example illustrates the use of the ASSEMBLR macro 
instruction to specify Assembler F. 

ASSEMBLR DESIGN=F 
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CENPROCS 



The CENPROCS macro instruction describes the central processing unit and its 
physical features. This macro instruction is required. 



Basic Requirements 



For S/360 Model 40: The keyword parameter INSTSET must be specified for 
this model or a system generation error will occur. 

For S/360 Model 91: The universal instruction set has only the EDIT and 
EDMK decimal instructions. A Decimal Simulator Routine can be specified 
with the OPTIONS keyword parameter in the SUPRVSOR macro instruction. 

For S/360 Model 40: If the universal instruction set is specified, the 
storage protection feature is not included. It is not standard for this 
model. 



Nucleus, Processor/Library, and I/O Device Generation 



The CENPROCS macro instruction must be coded with the same parameters and 
subparameters specified as those used in the last complete system generation 



Name 



Operation 
CENPROCS 



Operand 




145 
155 
158 
165 
168 
195, 
INSTSET=/STD \ 

JCOMM ( 

) SCNTF j 

lUNIV L 
[FEATURE= (feature [ , feature] ) ] 



CENPROCS 
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FEATURE= 

specifies the optional features installed in the central processing unit. 
These values can be written in any order. 

PROTECT (For Model 40} 

specifies the storage protection feature. 

S370 (For Model 195) 

specifies S/370 Model 195. 

Notes; 

• Program Support: The programming support for storage protection is 
specified by OPTIONS=PROTECT in the SUPRVSOR macro instruction. 

* Required: This subparameter is specified only for Model 40. It is 
a standard feature on all other systems and need not be specified. 

INSTSET= 

specifies the instruction set available in the central processing unit. 

STD 

specifies the standard instruction set. 

COMM 

specifies the commercial instruction set. This is the standard set 
with the decimal feature. 

SCNTF 

specifies the scientific instruction set. This is the standard set 
with the floating-point feature. 

ONIV 

specifies the universal instruction set. This is the standard set 
with the decimal, floating-point, and storage protection features. 

Note: if TYPE=MVT or M65MP is specified in the CTRLPROG macro 
instruction, this subparameter must be specified. 

Default: 



• If this keyword parameter is omitted for Model 40, a system generation 
error will occur. 

• ONIV is the default value only for Models 50, 65, 75, 85, 91, 155, 158, 
165, 168, and 195. 

• COMM is the default value for Models 135 and 145. 
Notes: 

• Model 40: The universal instruction set does not have the storage 
protection feature. 

• Model 91; The universal instruction set has only the EDIT and EDMK decimal 
instructions. (A Decimal Simulator routine for Model 91 may be specified 
with the OPTIONS keyword of the SUPRVSOR macro instruction.) 

• Model 195: The universal instruction set should be specified. If any 
other instruction set is specified, ONIV will be assumed. 
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MODEL= 

specifies the model of the central processing unit. 

Default: If this keyword parameter is omitted, 40 is assumed. 



Note: 

• M65HP Systems: 65 must be specified. 

STORAGE= 

Note : This parameter is no longer necessary. If specified, it is ignored. 

Coding Hints and Additional Information 

The chart below shows the relationship between two of the parameters in this 
macro instruction. 

Parameter Comment Parameter 

MODEL For 40 requires — INSTSET 

Example: In the following example, a CENPROCS macro instruction is used to 
describe a model 40 central processing unit. The commercial instruction set 
is used. 

CENPROCS MODEL=4 , INSTSET=COMM 



CENPROCS 
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CHANNEL 

The CHANNEL macro instruction describes the channel characteristics. This 
macro instruction is required. 

Basic Requirements 

• There must be a CHANNEL macro instruction for each channel of the 
installation's computinq system. 

• Burst devices cannot be attached to a multiplexor channel or to the 
multiplex portion of a hiqh-speed multiplexor channel. 

Nucleus Generation 

The CHANNEL macro instructions must be coded with the same keyword parameters 
and subparameters specified as those used in the last complete system 
qeneration. 

I/O Device Generation 

• Each channel in the computinq system must be specified. If the channel 
specifications are not chanqed, the same codinq must be repeated. 

• Channels can be added, deleted, or chanqed, but each channel in the new 
system must be specified. 

Name Operation Operand 

[name] CHANNEL ADDRESS=address 

fSELECTOR 



TYPE= 



MULTIPLEXOR 

HISPEEDMULTIPLEXOR 

BLKMPXR 



Name Field 

The name is used in system qeneration error messaqes (see Appendix D) to 
identify any CHANNEL macro instruction that produces an error. 

ADDRESS= 

specifies the address of the channel. 

address 

is a hexadecimal number from to D. 

TYPE= 

specifies the type of channel. 

SELECTOR 

is the selector channel. 

MULTIPLEXOR 

is the multiplexor channel. 

HISPEEDMULTIPLEXOR 

is the 2870 multiplexor channel. 

System Generation Macro Instructions 257 




BLKMPXR 

is the 2880 block, multiplexor channel or any other block 
multiplexor channel. 

Coding Hints and Additional Information 

When you use this macro instruction, the following guideline can be helpful. 

If nothing is coded in the name field, a sequential identification number is 
supplied by the assembler. This is done for any CHANNEL macro instruction 
that does not have a name. The order in which the numbers are assigned is 
determined by the order in which they appear in the input stream. For example, 
if the name is omitted from the third CHANNEL macro instruction, the name 
CHAN#3 is supplied in each diagnostic message resulting from an error detected 
while processing that macro instruction. 

Example: The following example illustrates the use of the CHANNEL macro 
instruction to describe a multiplexor channel with address 0. 



MPX CHANNEL ADDEESS=0 ,TYPE=MULTIPLEXOF 
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CHECKER 

The CHECKER macro instruction specifies the inclusion of the syntax checker 
for FORTRAN and/or PL/I language processors. This macro instruction applies 
only to systems having CRJE or TSO, and its use is optional. 

Basic Requirements 

• If both types of syntax checkers are to be included, two macro instructions 
must be used — one for each type. 

• OPTIONS-CRJE or TSO must be specified in the SCHEDULE macro instruction. 

• When TYPE-FORTRAN is coded, SIZE will be ignored. 

• When TYPE-PL 1 is coded, DESIGN will be ignored. 

Processor/Library Generation 

OPTIONS-CRJE or TSO must have been specified in the SCHEDULR macro instruction 
in the last complete system generation. 

Name Operation Operand 

CHECKER For FORTRAN: 

[DESIGN- ([E][,][G][,3[H]) ] 
TYPE-FORTRAN 

For PL/I: 

[SIZE- ([16K][,][2PX][,][27K]) ] 

TYPE-PL 1 

DESIGN- (For FORTRAN) 

specifies that one or more of the FORTRAN syntax checker design levels 
are to be included. 

E 

specifies the E-design level. 

G 

specifies the G-design level. 

H 

specifies the H-design level. 

Default: When TYPE-FORTRAN and this keyword parameter is not coded, design- 
level G is assumed. 

Note: 

The design level specified should agree with the design level specified in 
the FORTRAN macro instruction. 
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20K 



27K 



SIZE= (For PL/I) 

specifies that one or more versions of the PL/1 syntax checker are to be 
included. Only one checker version can be used in a TSO system. If 
OPTIONS=TSO is specified in the SCHEDULR macro instruction and more than 
one version of the PL/I syntax checker is included, the TSO system will 
use the 20K version if specified; otherwise, it will use the 27K version. 

16K 

specifies the syntax checker for restricted checking. It is fully 
resident in 16K bytes of main storage. 

specifies the syntax checker for thorough checking that is partially 
dynamic in 20K bytes of main storage. 

specifies the syntax checker for thorough checking that is fully 
resident in 27K bytes of main storage. 

Default: When TYPE=PL1 and SIZE is not coded, the 20K form of the syntax 
checker is assumed. 

TIPE= 

specifies the type of syntax checker to be included. 

FORTRAN 

specifies the FORTRAN syntax checker. 

PL1 

specifies the PL/I syntax checker. 

Note: 

Required: This keyword parameter can have only one subparameter. To specify 
both forms of the syntax checker, two macro instructions must be coded. 

Coding Hints and Additional Information 

Example: This example illustrates the use of the CHECKER macro instructon 
to select the FORTRAN syntax checking routines. The G-design level will be 
included in the new system. 



CHECKER TIPE=FORTRAN 
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CKPTREST 

The CKPTREST macro instruction makes it possible for you to modify the standard 
list of ABEND cards. This macro instruction is optional. 

Basic Requirements 

• Checkpoint/restart is a standard feature in all systems. 

• Step restart can always be used based on the specifications in the RD 
parameter in the EXEC statement. 

• If the CHKPT macro instruction is used in any program or the RESTART keyword 
parameter is used in a JOB statement, the RESIDNT keyword parameter of 

the SUPRYSOR macro instruction must be specified — the subparameter ACSMETH 
for MFT systems and the subparameter RENTCODE for MVT and M65MP systems. 

Name Operation Operand 

CKPTREST [ELIGBLE= (code [ ,code] . . . ) ] 
[NOTELIG= (code[, code]...) 3 



ELIGBLE= 

specifies the user defined ABEND codes that are to be eligible for automatic 
restart. 

code 

is a decimal integer from to 4095. 

Notes: 



• Maximum: A maximum of ten values may be specified even though none of 
the standard system ABEND codes has been made not eligible. For further 
information, see OS Supervisor Services and Macro Instructions. 

• PL/I F Compiler: To force or cancel an automatic restart of a job step 
using the IHERES routine, the user completion code 4092 must be specified 
in the ELIGBLE parameter. The RD parameter must also be specified in the 
JOB or EXEC statement with R or RNC as the subparameter. 

NOTELIG=code 

specifies which of the operating system ABEND codes in the standard list 
below are not eligible for automatic restart. These codes may be listed 
in any order. 




001, 031, 033, 03A, 0A3, 
100, 106, 113, 117, 137, 
20A, 213, 214, 217, 2F3, 
313, 314, 317, 32D, 
413, 414, 417, 422, 
513, 514, 



0B0, 0F3 ( 
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Default: If this parameter is omitted, all the ABEND codes listed above are 
eligible for automatic restart. 

Coding Hints and Additional Information 

More detailed information about ABEND codes can be found in the OS Messages 
and Codes and OS Supervisor Services and Macro Instructions. 

Example; This example illustrates the use of the CKPTREST macro instruction 
to select ABEND codes for automatic restart. The operating system ABEND codes 
of 03A, 626, and 317 are not to be eligible for automatic restart, and the 
user-defined codes of 95 and 122 are to be eligible. 

CKPTREST NOTELIG=(03A,626,317) ,ELIGBLE= (95, 122) 
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CMDLIB 

The CMDLIB macro instruction specifies the inclusion of the TSO Command 
Processing Programs Library (SYS 1. CMDLIB) in the new operating system. This 
macro instruction is valid and required only in a complete or processor system 
generation of a TSO system. 

Basic Requirement 

The CMDLIB macro instruction must be specified, if the OUTPUT and/or EDIT macro 
instructions are required. 

Processor/Library Generation 

• The CMDLIB macro instruction can be specified during a Processor/Library 
generation if it wasn't specified during the complete system generation. 

• The macro must not be respecified if the values selected for the parameter 
of the OUTPUT and EDIT macros are to be changed during a Processor/Library 
generation. 

Name Operation Operand 

CMDLIB 

Example: This example illustrates the use of the CMDLIB macro instruction 
to specify the inclusion of the TSO Command Processing Programs Library, 
SYS1. CMDLIB, in the new operating system. 

CMDLIB 
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COBLIB 

The COBLIB macro instruction specifies the inclusion of the COBOL subroutine 
library (SYS 1. COBLIB) in the new operating system. This macro instruction 
is optional. 

Basic Requirements 

• Space must be allocated for SYS 1. COBLIB. The data set may be cataloged 
in the new system. 

• A combined subroutine library, one that has E-design level and/or American 
National Standard COBOL, can be generated. A COBLIB macro instruction 
must be coded for each one that is desired. 

• If a combined subroutine library is desired, the UNIT and VOLNO keyword 
parameters should be the same in each COBLIB macro instruction. If they 
are not, the specification in the last COBLIB macro instruction will 
determine where the library will be placed. 

Processor/Library Generation 

• If a combined subroutine library is desired, the COBOL macro instruction 
must be specified. 

• If a combined subroutine library is going to replace an existing 

SYS1. COBLIB, there must be enough space for the new modules in the data 
set. 



Name Operation Operand 
COBLIB 



DESIGN= JE1 

fONIT=name ] 
LVOLNO=serialJ 



DESIGN= 

specifies the design level of the subroutine library. 



specifies design-level E. 



specifies American National Standard COBOL, X3. 23-1968, 

Note ; 

• Model 91 or 195; Design-level E cannot be specified. 
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ONIT= 

specifies the direct-access device that will hold the volume that will 
contain the COBOL library. 

name 

is the device type. 

Default: If the UNIT and VOLNO keyword parameters are omitted, the COBOL 
subroutine library is placed on the new system-residence volume. 

Notes: 

• Device: The direct-access device specified must exist in the generating 
system. 

• Keguired: If this keyword parameter is coded, VOLNO must also be specified, 

VOLNO= 

specifies the volume that is to contain the new COBOL subroutine library. 

serial 

is the serial number. 

Default: If the UNIT and VOLNO keyword parameters are omitted, the COBOL 
subroutine library is placed on the new system-residence volume. 

Notes: 

• Serial number: The value specified must be the same as the value given 
to the VOLUME keyword of the DD statement used to allocate space for 
SYS1.C0BLIB during the preparation for system generation. 

• Reguired: If this keyword parameter is coded, UNIT must also be specified. 

Coding Hints and Additional Information 

This example illustrates the use of the COBLIB macro instruction to specify 
the inclusion of the American National Standard COBOL subroutine library in 
the new operating system. SYS1. COBLIB is to reside on the new system-residence 
volume. 

COBLIB DESIGN=U 
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COBOL 



The COBOL macro instruction specifies the inclusion of the COBOL compiler. 
This macro instruction is optional. 



Basic Requirements 



INSTSET^COMM or ONIY must be specified in the CENPROCS macro instruction. 
The commercial or the universal instruction set is required for COBOL 
compilations and executions. 

INSTSET=UNIV must be specified in the CENPROCS macro instruction if either 
floating-point literals are used at compilation time, or exponentiation 
to a noninteger power or a floating-point number is used at object time. 

The COBLIB macro instruction must be specified. 

This macro instruction must be coded once for each design level. 



For MVT (including M65MP) Systems: 
are going to be used and the F128 li 
the REGION parameter in the cataloge 
must be changed. The alias for the 
linkage editor included in the syste 
in which case the alias is given to 
use the IEBUPDTE utility program. I 
provided in OS Storage Estimates. 



If IBM-supplied cataloged procedures 
nkage editor is included in the system, 
d procedures with linkage editor steps 
linkage editor, IEWL, is given to the 
m, unless more than one is specified, 
the largest. To change the parameter, 
nformation about region sizes is 



Processor/Library Generation 



Sufficient space must have been allocated for the new compiler in 
SYS1.LINKLIB. 



The same design level as a previously generated COBOL compiler can be 
specified. 

If a different design level of the COBOL compiler is specified, the COBLIB 
macro instruction must also be specified. This must be done to have a 
combined subroutine library generated. 



Name 



Operation 
COBOL 



Operand 
For COBOL E 




DESIGN=E 

msglev= [ flagwt 
IflageI 

[LINECNT=lines 
fDMAP 



DATAMAP= 



PROCMAP= 



DISPCHK= 



NODMAPJ 
PMAP 



NOPMAP 
DISPCK 



NODISPCK. 
" BUFSIZE=number ] 
EDIT= fREGED V) 
tlNVEDJJ 



}] 
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For American National Standard COBOL 

DESIGN=U 
MSGLEV= [FLAGW] 



fFLAGWl l 
IFLAGEJJ 



[LINECNT=lines] 
SIZE=size ] 
BOF=number] 
SORLIST= fSjOORCE 1] 

Ino source JJ 

PTJNCH= [ NODECK 11 
[DECK JJ 
TYPERUN= [ LOAD 11 

InoloadJJ 

SEQCHK= f SEQ 



SPACE= 



NOSEQ 
SPACE1 



SPACE2 

SPACE3 

rLITCHAR=fAPOST_ 

IQUOTEJ 

REPLIST= jNOXREFl] 

IXREF JJ 

CNDENSE= fNOCLIST 



HI 



fNOCLISTl ] 
[CLIST J J 



SUPPRESS [ NQSUPMAP1 ] 
[SUPMAP JJ 



DATAMAP= 
PROCMAP= 
TRNCATE= 



fNODHAPl 



DMAP 
NOPMAPl 



PHAP 
NOTRUNC I 



TRUNC I 



[LIB= I LIB ]] 
I INOLIBM 

[VERB= [ VERB 
I INOVERB 



DESIGN= 

specifies the design level of the COBOL compiler. 



specifies design-level E. 

specifies American National Standard COBOL, X3. 23-1968. 



Note: 



Model 91 or 195: Design- level E cannot be specified if MODEL=91 or 195 is 
specified in the CENPROCS macro instruction. 

The following keyword parameters provide the default options for the various 
options that can affect a COBOL compilation. These default options will be 
used if the corresponding values are omitted from the PARM field of the EXEC 
statement for the COBOL compilation. 
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BUF= (For American National Standard) 

specifies the number of bytes of main storage to be used for buffer 
allocation by the American National Standard COBOL compiler. 

number 

is an integer from 2768 to 99999. 

Defaults: 

• If BUF is omitted and SIZE is specified, the value of B0"F is calculated 

9.5 • 

SIZE-81920 + 2768 

• If both BUF and SIZE are omitted, a value of 2768 is assumed for BUF. 
Note: 

This value must be included in the value given to the SIZE keyword parameter. 

BUFSIZE= (For E) 

specifies the size, in bytes, of each of the six work buffers used during 
a COBOL compilation. 

number 

is a number from: 

180 to 32000 for magnetic tape, 

180 to 3600 for volumes on 2311 Disk Storage drives, or 

180 to 20000 for volumes on 2301 Drum Storage drives. 

Default: If this parameter is omitted, a value of 180 is assumed. 

Notes: 

• Size: The maximum size is an object time option, not checked during system 
generation. 

• Formula: The following formula can be used as a guide to determine the 
maximum value that can be specified to optimize the allocation of available 
storage for the data-name table and work buffers. (Any remainder should 

be ignored.) 

number = M-3000Q-[ (13+L) (N) 1 
6 

number 

is the size of each work buffer. If the result is less than 180, 
180 must be specified. 




is the size (in bytes) of main storage, 
is the length of the average data name. 
is the number of data names. 
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CNDENSE= (For American National Standard) 

CLIST 

specifies that a condensed listing will be produced. A condensed 
listing contains, in the procedure portion, the source card numbers 
and the first generated instruction for each verb. 

Note: Restriction - If CLIST is specified, PROCMAP=PMAP cannot be 
specified. 

NOCLIST 

specifies that no condensed listing will be produced. 

Default; If this keyword parameter is omitted, NOCLIST is assumed. 

DATAMAP= (For E or American National Standard COBOL) 

specifies the production of a listing of the data names and their addresses 
either relative to load point for the working storage section or relative 
to the record addresses for the file or linkage sections. 

DHAP 

specifies that a listing is to be produced. 

NODMAP 

specifies that the listing is not to be produced. 

Default: The default option is DMAP for E level COBOL and NODMAP for American 
National Standard COBOL. 

DISPCHK= (For E) 

specifies the generation of object code which determines whether a field 
to be displayed exceeds the record length of the device on which it is 
to be written. 

DISPCK 

specifies that a check is to be made. 

NODISPCK 

specifies that no check is required. 

Default: If this keyword parameter is omitted, DISPCK is assumed. 

EDIT= (For E) 

specifies the editing function to be used by the compiler. 

REGED 

specifies that the standard monetary editing function will be used. 

INVED 

specifies that the inverted monetary editing function will be used. 

Default : If this keyword parameter is omitted, REGED is assumed. 

LIB= (For American National Standard) 

specifies whether or not a COPY and/or a BASIS request will be part of the 
COBOL source input stream. 

LIB 

specifies that a COPY and/or a BASIS request will be made. 

NOLIB 

specifies that a copy source will not include a COPY or a BASIS request. 

Default : If this keyword parameter is omitted, LIB is assumed. 
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LINECNT= (For all design levels) 

specifies the number of lines to be printed on each page of the COBOL 
compiler output listing. 

lines 

is a two-digit integer from 10 to 99. 

Default; If this keyword parameter is omitted, a value of 60 is assumed. 

LITCHAR= (For American National Standard) 

identifies the character that will be used to delineate literals. It will 
also be used by the compiler to delineate figurative constants. 

A POST 

specifies that the apostrophe (') will be used. 

QUOTE 

specifies that the double guote (") will be used. 

Default: If this keyword parameter is omitted, APOST is assumed. 

MSGLEV= (For all design levels) 

specifies the type of compilation error messages to be printed. 

FLAGW 

specifies that all warning and error messages are to be printed. 

FLAGE 

specifies that warning messages are not to be printed. 

Default: If this keyword parameter is omitted, FLAGW is assumed. 

PROCMAP= (For E or American National Standard COBOL) 

specifies the production of a listing of the generated instructions for 
each statement in the Procedure Division. 

PMAP 

specifies that the listing is to be produced. 

Note: 



Restriction: If PMAP is specified, CNDENSE=CLIST cannot be specified. 

NOPMAP 

specifies that the listing is not to be produced. 

Default: The default option is PHAP for E level COBOL and NOPMAP for American 
National Standard COBOL. 

P0NCH= (For American National Standard COBOL) 

specifies the production of a punched deck of the object program. 

DECK 

specifies that a punched deck is to be produced. 

NODECK 

specifies that a punched deck is not to be; produced. 

Default: If this keyword parameter is omitted, NODECK is assumed. 
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REFLIST= (For American National Standard) 

XREF 

specifies that a cross listing will be produced. 

NOXREF 

specifies that no cross listing will be produced. 

Default: If this keyword parameter is omitted, NOXREF is assumed. 

SEQCHK= (For American National Standard) 

specifies the checking of the source program card seguence numbers. 

SEQ 

specifies that the source program card seguence numbers are to be 
checked. 

NOSEQ 

specifies that the source program card seguence numbers are not to 
be checked. 

Default: If this keyword parameter is omitted, SEQ is assumed. 

SIZE= (For American National Standard) 

specifies the number of bytes of main storage available to the American 
National Standard COBOL compilers. 

size 

is an integer from 81920 to 9999999. 

Default: If this keyword parameter is omitted, a value of 81920 is assumed, 

Note: 

For further information on this parameter, refer to OS American National 
Standard COBOL Programmer's Guide. 

SORLIST= (For American National Standard) 

specifies the production of a listing of the COBOL source program. 

SOURCE 

specifies that the listing is to be produced. 

NOSOURCE 

specifies that the listing is not to be produced. 

Default: If this keyword parameter is omitted, SOURCE is assumed. 
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SPACE= (For American National Standard) 

specifies the line spacing on the listing obtained when the SOURCE and/or 
MAP options are specified. 

SPACE1 

specifies single spacing. 

SPACE2 

specifies double spacing. 

SPACE3 

specifies triple spacing. 

Default: If this keyword parameter is omitted, SPACE 1 is assumed. 

SOPPRES= (For American National Standard) 

NOSUPMAP 

specifies that the object code listing, the object deck, and the load 
module, if the E-level message is generated by the compiler, are to 
be produced. 

SUPMAP 

specifies that the above items are to be suppressed. 

Default; If this keyword parameter is omitted, NOSUPMAP is assumed. 

TRNCATE= (For American National Standard) 

identifies the treatment of the computational (binary) items during a move 
operation. 

TRUNC 

specifies that the item is moved to a receiving field according to 
the specification in the PICTURE clause. 

NOTRUNC 

specifies that the item is moved to a receiving field according to 
the size of the field in storage (half word, fullword, etc.) 

Default: If this keyword parameter is omitted, NOTRUNC is assumed. 

TYPERUN= (For American National Standard) 

specifies the production of input to the linkage editor from the program 
being compiled. 

LOAD 

specifies that the program is to be processed by the linkage editor 
after compilation. 

NOLOAD 

specifies that the program is to be compiled only. 

Default: If this keyword parameter is omitted, LOAD is assumed, 

VERB= (For American National Standard) 

specifies whether procedure and verb names are to be listed with the 
associated code on the object program listing. 

VERB 

specifies that the names should be listed. 

NOVERB 

specifies that the names should not be listed. 

Default: If this keyword parameter is omitted, VERB is assumed. 
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Coding Hints and Additional Information 

The following guidelines can be helpful. 

• BUF and SIZE: The value for BUF must be included when the value for SIZE 
is determined. 

• PROC-PHAP and CNDENSE=CLIST: These two are mutually exclusive. 

Example: The following example illustrates the use of the COBOL macro 
instruction to specify an E- design- level COBOL compiler. The number of lines 
to be printed in each compiler output listing is 55. Listings of data names 
and their addresses and listings of the generated instructions for each 
statement in the Procedure Division are to be produced. All warning and error 
messages are to be printed. The generation of object code to determine the 
length of fields to be displayed is not required. The size of each of the 
six work buffers used during a COBOL compilation is 5708. The standard monetary 
editing function will be used. 

The formula used to compute the BUFSIZE value is as follows: 

65536-30000-C (13+10) (56) ] = 5708 

5 

where the main-storage size is 64K, the length of the average data name is 10, 
and the number of data names is 56. 

COBOL DESIGN=E,LINECNT=55,DISPCHK=NODISPCK,BUFSIZE=5708 
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CTRLPROG 



The CTRLPROG macro instruction specifies the control program options. This 
macro instruction is required. 

Basic Requirements 

• Models 91 or 195; MVT must be specified if M0DEL=91 or 195 is specified 
in the CENPROCS macro instruction. 

• S/370 Models 145, 155, 158, 165 or 168; MFT or MVT must be specified if 
MODEL=145, 155, 158, 165 or 168 is specified in the CENPROCS macro instruction, 

• S/370 Model 135: MFT must be specified if MODEL=135 is specified in the 
CENPROCS macro instruction. 



Nucleus Generation 



• The type of control program specified must be the same as that specified 
in the last complete system generation. Each nucleus of an operating 
system must support the same control program, because the resident portion 
of the control program (nucleus) must be compatible with the nonresident 
portion. 

• The subparameters for the following keyword parameters can be changed: 
TMSLICE, QSPACE, MAXIO, and ADDTRAN. The other keyword parameters must 
be coded the same as for the last complete system generation. 

I/O Device Generation 

Keyword parameters, other than MAXIO, must be the same as those specified 
in the last complete system generation. 



Name 



Operation 
CTRLPROG 



Operand 
For MFT 



TYPE=MFT 
MAXIO=number 
HIARCHY* 



OVERLAY* 



EXCLUDE ]] 

INCLODEJ 

BASIC 



ADVANCED 




FETCH* fSTDll 

[SYSQOE=size] 

[ TMSLICE* (Pn-Pm,SLC-time) ] 



System Generation Macro Instructions 275 



Name 



Operation 

CTRLPROG 
(Cont.) 



Operand 

For MVT 

TYPE=MVT 
MAXIO=number 

HTARCHY= ( EXCLUDE ]] 
tlNCLODEjJ 

TMSLICE= (priority, SLC-time 
[, priority, SLC-time]. 
[OPTIONS=([ ROLLOUT]) ] 
I QSPACE=number ] 
l ADDTRAN=number ] 
[ OVERLAY= ASYCHRON ] 



.) ] 



WARN: 



Ml} 



For M65MP 

TYPE=M65MP 

[ HIARCHY= EXCLUDE ] 

[ THSLICE= (priority, SLC-time 

[, priority, SLC-time[ . ..) ] 
MAXIO=number 
[OPTIONS=([ ROLLOUT]) ] 
[ QSPACE=number ] 
[ADDTRAN=number] 
[ OVERLAY=ASYCHRON ] 



ADDTRAN= (For MVT including M65MP) 

specifies additional pairs of transient areas to a maximum of 32 
transient areas. 



numoer 

is the number of areas. 

Note: 



(A decimal number from 1 to 15.) 



The multiple-line WTO facility, used in writing status displays to the 
operator's console, requires adequate transient area support to ensure 
prompt response to operator requests. System response can be enhanced 
by the use of the resident type 3 and 4 SVC facility (specified in a 
SUPRVSOR macro) . 

FETCH= 

specifies the type of program fetch to be used. 

STD (For MFT) 

specifies standard fetch. 

PCI (For MFT) 

specifies the use of Program Controlled Interrupt during fetching 
of a program into storage. 

Default: If HIARCHY=INCLUDE is specified, FETCH=PCI is assumed. 



276 OS System Generation 



HIARCHY= (For all types) 

specifies storage hierarchies for the system. 

EXCLUDE 

specifies that the system is not to have storage hierarchies. 

INCLUDE 

specifies that the storage hierarchy facility is to be in the new 
system. 

Default: If this keyword parameter is omitted, EXCLUDE is assumed. 

Notes: 

• MFT: Hierarchies for partitions are defined in the PARTITNS macro 
instruction. 

• HVT: The hierarchy structure will be maintained even though there 
may not be a 2361 Core Storage unit on the system. 

• Restriction: HIARCHY=INCLUDE cannot be specified if TYPE=H65MP, or 

if 91, 145, 155, 158, 165, 168, 195, or M85 is specified in the CENPROCS 
macro instruction. 

If HIARCHY=INCLUDE is specified, main storage cannot be more than 1024K. 

MAXIO= (For all types) 

specifies the maximum number of I/O operations that can be simultaneously 
processed by the new operating system. This number is the sum of those 
I/O operations that can be executed simultaneously and those that can be 
gueued while not being executed. 

number 

is a decimal number. 



Notes: 



Channel Programs: This number limits the maximum number of channel programs 
that can be started when using access methods or graphic programming 
services. 

Formula: A recommended minimum value for this parameter is 1 for each 
teleprocessing or unit record device, t for every four direct-access 
devices, and 1 for every two graphics or tape devices. The value specified 
should be at least equal to the maximum number of channel programs that 
may be active at any one time. 




0PTI0NS= 



ROLLOUT (For HYT including H65MP) 

specifies the inclusion of the rollout/rollin function. 



Note 



The rollout/rollin function requires that SYS1. ROLLOUT be cataloged in 
the new system before IPL. 
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OVERLAY= 

specifies the overlay supervisor options. 

BASIC (For MFT) 

specifies synchronous overlay without exclusive call checking. 

ADVANCED (For MFT) 

specifies synchronous overlay with error checking for invalid SEGWT 
instructions. 

ASYCHRON (For MVT including M65MP) 

specifies the asynchronous overlay supervisor for MVT. 

Defaults: 

• For MFT: If this keyword parameter is omitted, BASIC is assumed. 

• For MVT (including M65MP) : If this keyword parameter is omitted, ASYCHRON 
is assumed. 

QSPACE= (For MVT including M65MP) 

specifies the number of 2048-byte blocks reguired for the system gueue 
area. 

number 

is a decimal number. 

Default: If this keyword parameter is omitted, a value of 10 is assumed. 

Notes: 



• Changes; The value specified can be changed at IPL time if OPTION=COMM 
is specified in the SUPRVSOR macro instruction. Refer to OS Storage 
Estimates for information on what value to specify for this keyword 
parameter. 

• SMF: If SMF has been specified in the ACCTRTN keyword parameter of the 
SCHEDOLR macro instruction, then additional system gueue area must be 
added. See OS Storage Estimates for the formula to use to calculate the 
system gueue area size. 

SYSQUE= (For MFT) 

specifies the size of the system gueue area (SQA) in bytes. 

size 

is a decimal number. 

Note: The number must be in double word multiples. See OS Storage 
Estimates for the formula for the system gueue area- 
Defaults: 



• If MCS is not specified and this keyword parameter is omitted, a value 
of 1600 is assumed. 

• If CONOPTS=MCS is specified in the SCHEDtJLR macro instruction and this 
keyword parameter is omitted, or if less than 2600 is coded, then 2600 
is assumed. 

Notes: 

• MCS: If CONOPTS=MCS is specified, additional space will be reguired in 
the system gueue area. 
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• MPT Systems With Subtasking: The number of subtasks that can be handled 
is partially determined by the size of the system queue area. 

• SMF: If SMF has been specified in the ACCTRTN keyword parameter of the 
SCHEDULR macro instruction, then additional system queue area must be 
added. 

TMSLICE= (For HFT) 

specifies time-slicing for the jobs scheduled into a continuous group of 
partitions. 

Pn-Pm 

specifies the continuous group of partitions. 

n 

is the lowest partition number. 

m 

is the highest partition number. 

Note: 

Required: The partition numbers used must also be specified in the PARTITNS 
macro instruction. 

SLC-time 

is a decimal integer from 20 to 9999 that specifies the maximum number 

of milliseconds for which each ready task in the group of partitions 

is to have control of the CPD during one pass through the group. 

Notes: 

• Changes: The values speciixed can ue changed when the scheduler is made 
ready after IPL if OPTI0NS=C0MM is specified in the SOPRVSOR macro 
instruction. 

• Job Class: To ensure that all jobs of a given class are time-sliced, that 
job class should be specified only for partitions in the group defined 

by Pn-Pm. The classes of job that can be scheduled into each partition 
are specified in the PARTITNS macro instruction. 

TMSLICE= (For MVT including M65MP) 

specifies time-slicing for all tasks that have a given priority number. 

Priority 

is a decimal integer from to 13 that specifies the priority number. 

SLC-time 

is a decimal integer from 20 to 9999 that specifies the maximum number" 

of milliseconds for which each ready task of the priority specified 

is to have control of the CPU during one pass through the group. 

Notes: 

• Positional: These two subparameters must be written in the order shown. 

• Time-Slicing: Can be specified for each of the 14 priorities. 

• Required: When this keyword parameter is specified, TIMER=INTER?AL or 
JOBSTEP must be specified in the SDPRVSOR macro instruction. 

TYPE= 

specifies the type of control program. 

MFT 

specifies multiprogramming with a fixed number of tasks. 

Note: The PARTITNS macro instruction must be specified. 
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CTRLPROG 



MVT 

specifies multiprogramming with a variable number of tasks. 

Notes; 

• Required; This type of control program can operate only on a S/360 
Model 40 or larger central processing unit that has at least 256K 
bytes of main storage. The universal instruction set is also reguired. 
(See the CEMPROCS macro instruction.) 

• Model 91 ; If M0DEL=91 is specified in the CENPROCS macro instruction, 
this subparameter must be specified 

• Model 195: If MODELS 195 is specified in the CENPROCS macro 
instruction, this subparameter must be specified. 

M65MP 

specifies the version of MVT that controls multiprocessing and uses 
two S/360 Model 65s. 

Note; 

Reguired; This type of control program can operate only on a Model 65 
multiprocessing system (in the multisystem mode or partitioned mode) that 
has at least 512K bytes of main storage. INSTSET-UNIV must be specified 
in the CENPROCS macro instruction. 

Default: If this keyword parameter is omitted, MVT is assumed. 

WARN= 

specifies the power warning feature time delay. 

£ specifies that the power warning feature is not supported. 

n a value of 1 specifies no time delay. 

a value of 2 to 16,777,215 specifies a time delay in 
milliseconds. 

Coding Hints and Additional Information 

The chart below shows the relationship between some parameters in this macro 
instruction. 

Parameter Condition Parameter 

HI ARCHY= INCLUDE assumes PETCH=PCI 

HIARCHY=INCLUDE invalid with TYPE=H65MP 

Examples; The following example illustrates the use of the CTRLPROG macro 
instruction to specify multiprogramming with a variable number of tasks. The 
maximum number of I/O operations that can be processed simultaneously is 30. 
The asynchronous overlay supervisor, service aids, and PCI fetch are assumed. 
Fifteen 2K blocks are specified for the system gueue area. 

There will be a total of six transient areas: the original pair plus two 
additional pairs. The rollout/rollin function is not included. All tasks 
having a priority of 10 can have control of the CPU for a maximum of 512 
milliseconds at a time; those with a priority of 7 can have control for a 
maximum of 256 milliseconds at a time. 

CTRLPROG TYPE=MVT,MAXIO*30,QSPACE=15,ADDTRAN*2, 
TMSLICE* (10,SLC-512, 7, SLC-256) 
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DATAMGT 

The DATAMGT macro instruction allows optional access methods. This macro 
instruction is optional. 

Basic Requirements 

• If the track overflow feature is to be used, CIRB must be included in 
the system. 

• CIRB ; If CIRB is desired in the new system, BDAM, ISAM, BTAM, or a 
3211 printer must be specified. 

• The basic sequential access method (BSAM) and the basic partitioned access 
method (BPAM) are provided automatically with all types of control programs. 

• BTAM or QTAM: If either or both access methods are specified, 
TIMER=INTERVAL or JOBSTEP must be specified in the SOPRVSOR macro 
instruction. The generation of SYS1. TELCMLIB is specified with the TELCMLIB 
macro instruction. 

• TCAM: TCAM and BDAM must be specified. TIMER= INTERVAL or JOBSTEP 

must be specified and if the control program is MFT, OPTIOKS=ATTACH must 
also be specified in the SOPRVSOR macro instruction. SYS 1. TELCMLIB must 
be specified with the TELCMLIB macro instruction. 

• CRJE: If conversational remote job entry (CRJE) is to be used in the new 
system, BTAM must be specified. 

• RJE: If remote job entry (RJE) is to be used in the new system, BTAM and 
BDAM must be specified. 

• TSO: BDAM and TCAM will be assumed if they are not specified. 

Nucleus Generation 

If this macro instruction was used during the last complete system generation, 
it must be respecified during this type of generation. The same parameters 
and operands must be coded. 



I/O Device Generation 

• If this macro instruction was used during the last complete system 
generation, it must be respecified during this type of generation. The 
same parameters and operands must be coded. 

• If this macro instruction was not used during the last complete system 
generation, it cannot be coded during this type of generation. 

Name Operation Operand 

DATAMGT ACSMETH= (method[ , method ]. . . ) 



DATAMGT 
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ACSMETH= 

specifies the optional access methods to be included. 

BDAM 

is the basic direct access method (BDAM) and routines for creating 
a direct access data set. 

ISAM 

is the queued and basic index sequential access methods (QISAM and 
BISAM) . 

BTAM 

is the basic telecommunications access method (BTAM) . 

QTAM 

is the queued telecommunications access method (QTAM) . 

TCAM 

is the telecommunications access method (TCAM) . 

Note: 



Coding: These values may be listed in any order. 

Coding Hints and Additional Information 

The following example illustrates the use of the DATAMGT macro instruction 
to specify that the basic direct-access method is to be included in the new 
operating system. 



DATAMGT ACSMETH=BDAM 



282 OS System Generation 



DCMLIB 

The DCMLIB macro instruction specifies the inclusion of the display control 
module library (SYS1 .DCMLIB) in the new operating system. This macro 
instruction is optional. 

Basic Requirements 

• Space must be allocated for SYS 1. DCHLIB 

• SIS 1. DCMLIB must be cataloged in the new system during system generation. 

I/O Device Generation 

• SYS1. DCMLIB is required if transient DCM support or PFK command entry 
has been specified for operator display consoles. 

Name Operation Operand 



DCMLIB rONIT=name 



LVOLNO-seria 



ialj 



ONIT= 

specifies a direct-access device in the generating system on which the 
DCM library is to be generated. 

name 

is the device type 

VOLNO= 

specifies the volume that is to contain the DCM library, 

serial 

is the serial number 

Default: If the UNIT and VOLNO parameters are omitted, the DCM library is 
placed on the LINKVOL volume as specified in the GENERATE macro. 

Notes: 

• Required: VOLNO and UNIT must be coded. 

• Value: The amount of storage allocated to SYS1. DCMLIB is specified by the 
SPACE parameter of the DCMLIB DD statement during preparation for system 
generation. 

Coding Hints and Additional Information 

This example illustrates the use of the DCMLIB macro instruction to include 
the display control module library in the new operating system. The unit name 
is 2311; the volume serial number is 003475. 




DCMLIB ONIT-2311,VOLNO=003475 
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EDIT 

The EDIT macro instruction specifies the physical characteristics and processing 
attributes of the various types of data sets (see Figure 80) you want processed 
by the TSO EDIT command. Three programs may be specified for each data set 
type: an exit routine for processing user-defined information during the EDIT 
command initialization, a syntax checker, and a processor or prompter to which 
the EDIT data set will be supplied when the RON subcommand of EDIT is issued. 
This macro is optional and valid only in a complete or processor system 
generation of a TSO system. 

Basic Requirement 

The CMDLIB macro instruction must be specified if the EDIT macro instruction 
is specified. However, if you want all of the EDIT data set attribute 
defaults, the EDIT macro need not be specified as long as the CMDLIB macro 
is specified. 

Processor/Library Generation 

CMDLIB must be specified during a Processor/Library generation if it was not 
specified during the complete generation. 

Name Operation Operand 

EDIT DSTYPE* (name[ ,name].. . ) 

BLOCK* ([n],[n ],...) 

(FIXED ) 
FORMAT* ( {VAR \ , ... ) 

(fxdonlyJ 

FIXED* ([ d-m ], [ d-m ],...) 
VAR=([ d-m], [d-m ],...) 

{CAPS ) 
ASIS },...) 
CAPSONLY) 

CHECKER* ([ name ],[ name ],... ) 

OSEREXT* ([name], [name ],...) 

PRMPTR* ( [name] , [name] , . . . ) 

DSERSRC* (/DATASEt\,[ . . . ]) 
(INCORE < 

Note; Commas are required to denote missing operands on all keywords except 
DSTYPE. Defaults for omitted operands are listed in Figure 80. 

DSTYPE* 

specifies the IBS standard or user-defined data set type (see Figure 80) 
that are to have their attributes modified or defined for use by the TSO 
EDIT command. 

name 

is the 1- to 8-character data set type as it will appear in the TSO 
EDIT command. Any data set type permitted by the TSO EDIT command 
or defined by the installation is permitted here. Op to ten user- 
defined data set types, in addition to any of the standard data set 
types, can be specified up to a total of eighteen. (See Figure 80.) 
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BLOCK= 

specifies the default block length, in bytes, for the new data sets created 
by the TSO EDIT command. 

n 

specifies the default blocksize for any data set of the type specified 
by the associated NAME field of the DSTYPE operand. The value of 
n is an integer from 1 to 32760. 

FORMAT= 

specifies the allowable record format for new data sets created by the 
TSO EDIT command. 

FIXED 

specifies that fixed record format is the default for data sets of 
the type specified by the associated NAME field of the DSTYPE operand. 



VAR 



specifies that variable record format is the default for data sets 
of the type specified by the NAME field of the DSTYPE operand. 



FXDONLY 

specifies that only fixed record format is allowable for data sets 
of the type specified by the associated NAME field of the DSTYPE 
operand. Specifying the VAR operand for this data set type is 
considered invalid. 

FIXED= 

specifies the default and maximum logical-record length, in bytes, with 
fixed record format, for new data sets created by the TSO EDIT command. 

d 

specifies the default logical-record length for any fixed format data 
set of the type specified by the NAME field of the DSTYPE operand. 
The value of d is an integer from 1 to 255, and the associated n 
value, if specified, with the BLOCK operand must be a multiple of 
this value. If variable-record format is the default for the data 
set type, and if this keyword value is being used to define the maximum 
fixed-record length, a value of should be coded for d. 

is a hyphen, and must be coded exactly as shown. 

m 

specifies the maximum logical record length for any fixed format data 
set of the type specified by the associated NAME field of the DSTYPE 
operand. The value of m is an integer from 1 to 255. The associated 
N value if specified with the BLOCK operand, must be a multiple of 
this value, and the m value must be greater than or egual to the D 
value specified. 



286 OS System Generation 



A hi) JLO 



VAR= 

specifies the default and maximum allowable length, in bytes, of logical 
records with variable format for new data sets created by the TSO EDIT 
command. This operand should not be coded if FXDONLY is specified with 
the FORMAT operand for the associated data set type. 

d 

specifies the default logical-record length for any variable format 
data set of the type specified by the associated name field of the 
DSTYPE operand. The value of d is an integer from 5 to 255, and must 
be less than or equal to n-U of the associated N value specified with 
the BLOCK operand. 

is a hyphen, and must be coded exactly as shown. 

m 

specifies the maximum logical record length for any variable format 
data set of the type specified by the associated NAME field of the 
DSTYPE operand. The value of m is an integer from 5 to 255, and must 
be less than or equal to n-4 of the associated N value specified with 
the BLOCK operand and greater than or equal to the d value specified. 

CONVERT= 

specifies whether upper case conversion of characters is desired for the 
TSO EDIT command input data. 

CAPS 

specifies that the CAPS operand on the TSO EDIT command, which 
requests upper case conversion of data, is to be the default for data 
sets of the type specified by the associated NAME field of the DSTYPE 
operand. 

specifies that the ASIS operand on the TSO EDIT command, which requests 
that the data remain as entered (for example, upper and lower case) , 
is to be the default for data sets of the type specified by the 
associated NAME field of the DSTYPE operand. 

CAPSONLY 

specifies that the CAPS operand of the TSO EDIT command is the only 
permitted operand. The ASIS operand may not be specified on the TSO 
EDIT command. 

CHECKER^ 

specifies the installation-supplied processor that is to be used by the 
TSO EDIT command to check lines in the data set for proper syntax. 

name 

is the 1- to 8-character module name which the TSO EDIT command will 
use to invoke the CHECKER for data sets of the type specified by the 
associated NAME field of the DSTYPE operand. 

DSEREXT= 

specifies the installation-supplied user exit that is to be invoked by 
the TSO EDIT command to interpret the parameters specified in the subfield 
of the data set type operand of the TSO EDIT command. The encoded 
parameters will be passed as part of the parameter list to the specified 
processor in the CHECKER operand. This operand is invalid for any of the 
standard data set types. 

name 

is the 1 to 8 character exit name for data sets of the type specified 
by the associated NAME field of the DSTYPE operand. 
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PRMPTR= 

specifies the installation-supplied processor that is to be used by the 
RUN subcommand of the TSO EDIT command. RON invokes an installation- 
supplied compiler to execute programs under the TSO EDIT command. 

name 

is the 1- to 8-character prompter name for data sets of the type 
specified by the associated NAME field of the DSTYPE operand. 

OSERSRC= 

specifies the type of source input acceptable to the processor specified 
in the PRMPTR operand under the TSO EDIT command. 

DATASET 

specifies that the only allowable source of input to the processor 
specified in the PRMPTR operand is a sequential data set. 

INCORE 

specifies that the TSO EDIT command may pass the input source to the 
specified processor in the form of an in-storage data set, if the 
source does not exceed 4096 bytes, or a sequential data set. 



Data Set Blocksize Record 
Type Format 

Standard Data Set Types 



Default 

LRECL 
F V 



Maximum 

LRECL 
F V 



Data 
Conversion 



Checker 
Name 



Prompter Prompter 
Name Input 



PLIF 

FORTE 

FORTG 

FORTH 

ASH 

TEXT 

DATA 

CLIST 

CNTL 

COBOL 

PLI 

IPLI 

BASIC 

GOFORT 

FORTGI 



400 

400 

400 

400 

1680 

1680 

1680 

1680 

1680 

4C0 

400 

1680 

1680 

1680 

400 



FXDONLY 

FXDONLY 

FXDONLY 

FXDONLY 

FXDONLY 

VAR 

FIXED 

VAR 

FXDONLY 

FXDONLY 

VAR 

VAR 

VAR 

VAR 

FXDONLY 



80 

80 

80 

80 

80 



80 



80 

80 









80 













255 



255 





104 

120 

120 

255 





100 
80 
80 
80 
80 



255 255 

255 255 

255 255 

80 

80 

100 104 

120 120 

120 120 

255 255 

80 — 



CAPSONLY 

CAPSONLY 

CAPSONLY 

CAPSONLY 

CAPSONLY 

ASIS 

CAPS 

CAPSONLY 

CAPSONLY 

CAPSONLY 

CAPS 

CAPSONLY 

CAPSONLY 

CAPS 

CAPSONLY 



PLIFSCAN — — DATASET 

IPDSNEXC — ~ DATASET 

IPDSNEXC — DATASET 

IPDSNEXC DATASET 

ASH * DATASET 

, DATASET 

DATASET 

,- , DATASET 

,. „-« DATASET 

„ COBOL* DATASET 

PLIC DATASET 

IKJNC211* IKJNC211* DATASET 

IKJNC211* IKJNC211* DATASET 

IPDSNEXC GOFORT* INCORE 

IPDSNEXC FORT* DATASET 



Any User Defined Data Set Types 
1680 FIXED 80 



255 255 CAPS 



*IBM Program Product. 
— Null Value 



Figure 80. Attribute Defaults for Operand Omitted on the EDIT Macro 
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Coding Hints and Additional Information 

Following are two examples that illustrate the use of the EDIT macro. 

EDIT DSTYPE=(OSER01 # DATA) , X 

BLOCK=(,2U00) , X 

FORMAT= (FIXED) 

In this example, a new data-set-type, USER01, is defined for the TSO EDIT 
command. Its default record format is fixed and all other system defaults 
are used (see Figure 80) . Also the standard data-set type, DATA, will have 
a default blocksize of 2400 instead of 1680 (see Figure 80). All other standard 
data-set types will use the default values in Figure 80. 

EDIT DSTYPE=(USER01,OSER02) , X 

BLOCK=(,U00) , X 

FORMAT=(,VAR) , X 

VAR=(, 104-104) , X 
FIXED= (,0-100) 

In this example, two new data-set-types, USER01 and OSER02, are defined for 
the TSO EDIT command. Data-set-type, OSER01, will use all the system defaults 
for its attributes (see Figure 80) . 

Data-set-type, USER02, will have a blocksize of 400. Its record format default 
will be variable with fixed allowable. Its variable format default and maximum 
logical record length will be 104. Since fixed record format is allowable, 
its fixed format maximum logical record length will be 100. 

Note that is coded for the fixed-format default logical-record length, since 
variable format is specified as the format default. All standard data-set 
types will use the default values in Figure 80. 
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EDITOR 

The EDITOR macro instruction specifies the inclusion of the linkage editor. 
This macro instruction is required for the first system generation and is 
optional after that. 



Basic Requirements 

• Each operating system must have a linkage editor. 

• This macro instruction must be coded once for each design level that is 
to be included in the new system. 

• The alias IEWL, used by the cataloged procedures, and the alias LINKEDIT, 
used by the supervisor-assisted linkages, are given to the linkage editor 
chosen. If more than one is included, the alias names are given to the 
largest linkage editor chosen. 

• MVT (including M65HP) System: If the F128 linkage editor is specified and 
IBH-supplied cataloged procedures are going to be used, the REGION parameter 
in the cataloged procedures that have linkage editor steps must be changed. 
The IEBUPDTE utility can be used to do this. Information about region 
sizes is provided in OS Storage Estimates. 



Processor/Library Generation 

• Additional design levels of the linkage editor can be included. 

• Sufficient space must have been allocated for any additional linkage editors 
in SYS1.LINKLIB. 

• The aliases IEWL and LINKEDIT are assigned to the largest (linkage editor 

in the modified system after this generation. The aliases can be reassigned 
after the generation is over by using the IEHPROGM system utility program. 

• The SIZE parameter for an F-design-level linkage editor can be changed 
by respecification of the same linkage editor during a Processor/Library 
generation. 




Name Operation Operand 

EDITOR 

DESIGN= 



F4U 
F88 
F128 



[SIZE=(size1 ,size2) ] 



System Generation Macro Instructions 291 



F88 



DESIGN= 

specifies the design level of the linkage editor to be included. 

FU4 

specifies the F- design- level linkage editor that operates in 44K bytes 
of main storage. 

specifies the F-design-level linkage editor that operates in 88K bytes 
of main storage. 

F128 

specifies the F- design- level, linkage editor that operates in 128K 
bytes of main storage. 

SIZE= (For all design levels) 

specifies the default options at link-edit time for the maximum number 
of bytes of main storage available to the linkage editor and to its 
corresponding TEXT buffer. The values specified must be of the form nnnnK, 
where nnnn is an integer and K represents 1024 bytes. 

sizel 

is a value from the design level of the linkage editor (44K, 88K, 
or 128K) to 9999K. It specifies the storage available to the linkage 

editor. 

Default: If this subparameter is omitted, a value of 90K is assumed for 
the F44 or F88 linkage editors, or of 128K for the F128 linkage editor. 

Note: 

Required: If this subparameter is specified, it must be coded first. 

size2 

is a value from 6K to 100K. It specifies the storage available to 
the TEXT buffer. 

Default: If this subparameter is omitted, 16K is assumed for the F44 linkage 
editor, 8K for the F88 linkage editor, or 18K for the F128 linkage editor. 

Notes: 

• Required: If both subparameters are specified, this one must be coded 
last. If only this one is specifie'd, it must be preceded by a comma. 

• Formula: The following conditions must also exist: 

Value = size2 < sizel - N 

N is 38K for F44 
is 52K for F88 
is 68K for F128 

Coding Hints and Additional Information 

The following example illustrates the use of the EDITOR macro instruction to 
specify the F-design-level linkage editor that operates in 88K bytes of main 
storage. There are 200K bytes available to the linkage editor and 8K available 
to the TEXT buffer. 



EDITOR DESIGN=F88,SIZE=200K 
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EMULATOR 

The EMULATOR macro instruction specifies the inclusion of certain support 
routines for integrated emulators in the new operating system. This macro 
instruction is optional. 

Basic Requirements 

• TIMER=JOBSTEP or INTERVAL must be specified in the SUPRVSOR macro 
instruction. 

• This macro instruction must be specified during a complete generation 
before an emulator can be assembled and link-edited into a system. 

• This macro instruction must not be coded for the M65MP system. 

• Enough room must be allocated in SYS1.LINKLIB for the emulator program 
that will be generated later unless the emulator will reside in another 
library that will be specified during emulation generation. 



Nucleus Generation 

This macro instruction must be specified in a nucleus generation if it was 
specified for the last complete generation. 

I/O Device Generation 

This macro instruction must be specified in an I/O device generation if it 
was specified for the last complete generation. 



Name Operation Operand 

EMULATOR 



Coding Hints and Additional Information 

Specific requirements for emulators on the S/360 Model 85 or S/370 Models 165 
or 168 include: 

• MODEL=85, 165 or 168 must be specified in the CENPROCS macro instruction. 

• TYPE=MFT or MVT must be specified for the CTRLPROG macro Instruction. 

• The OPTIONS operand of the SUPRVSOR macro instruction must include IDENTIFY 
and ATTACH for the MFT systems. 
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Specific requirements for emulators on the S/370 Models 135, 145, and 155 
include: 

• MODEL=135, 145, 155, or 158 must be specified in the CENPROCS macro 
instruction. 

• TYPE=MFT or MVT (Models 145, 155 and 158 only) must be specified in the 
CTRLPROG macro instruction. For the Model 135 only, TYPE=MFT can be 
specified. 

• If disk units are supported, ACSMETH=BDAM must be coded in the DATAMGT 
macro instruction. 

• If the 7074 emulator for the Model 155 is to be generated, the OPTIONS 
operand of the SUPRVSOR macro instruction must include IDENTIFY and ATTACH 
for the MFT systems. 

This macro will cause one or two special SVCs to be included in the new system; 

• SVC 88 for S/370 Models 135, 145, 155, 158, 165, and 168 

• SVC 88 and 89 for S/360 Model 85 

Detailed information about incorporating integrated emulators into the system 
is provided in: 

709/7090/7094 II Emulator Program for System/360 Model 85 

Emulating the IBM 140 1, 1440 and 1460 on the IBM System/370 Models 145 and 
155 using OS/367J 

Emulating the IBM 1410 and 7010 on the IBM System/370 Models 145 and 155 using 
OS/360 

Emulating the IBM 7074 on the IBM System/370 Models 155 and 165 using OS/360 

Emulating the IBM 7094 on the IBM Models 85 and 165 using OS/360 

Emulating the IBM 7080 on the IBM System/370 Model 165 using OS/360 

Example: 



This example illustrates the use of the EMULATOR macro instruction to include 
support for integrated emulators. 

EMULATOR 
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FORTLIB 

The FORTLIB macro instruction specifies the inclusion of the FORTRAN subroutine 
library (SYS 1 .FORTLIB) in the new operating system. This macro instruction 
is optional. 

Basic Requirements 

• Space must be allocated for SYS t. FORTLIB. The data set may be cataloged 
in the new system during the preparation for system generation. 

• Only one design level of SYS 1. FORTLIB can be generated during a system 
generation. 

• The G- and H-design-level libraries support programs compiled with any 
design level of the FORTRAN compiler. 

• The subroutines in any SYS1. FORTLIB can be used by any operating system 
program. 

• FORTRAN G and H cataloged procedures assume that the logical I/O units 
06, 05, and 07 have been specified for OBJERR, ONLNRD, and ONLNPCH, 
respectively. If these have not been specified in the OBJERR, ONLNRD, 
and ONLNPCH parameters, then the cataloged procedures must be modified 
as described in OS FORTRAN IV (G and H) Programmers Guide . 

• MVT (including M65MP) Systems: If IBM-supplied cataloged procedures are 
going to be used and the F128 linkage editor is included in the system, 
the REGION parameter in the cataloged procedures with linlc-edit steps must 
be changed. The alias for the linkage editor, IEWL, is given to the linkage 
editor included in the system, unless more than one is specified, in which 
case the alias is given to the largest. To change the parameter, use the 
IEBUPDTE utility program. Information about region sizes is provided in 

OS Storage Estimates. 

Processor/Library Generation 

• If the generating system is not the one being modified and the existing 
SYS 1. FORTLIB contains user-written modules or GSP: 

The catalog of the generating system must point to the existing 
SYS 1. FORTLIB. 

The new SYS 1. FORTLIB can be cataloged. 

If the new SYS1. FORTLIB is to be placed on the volume occupied by 
the existing SYS 1. FORTLIB, the existing one must be moved and 
recataloged. The space can be recovered by use of the IEBCOPY utility 
program. 

When the generation is over, the existing SYS1. FORTLIB must be 
scratched and uncataloged. 

• If the generating system is not the one being modified and the existing 
SYS1. FORTLIB does not contain any user-written modules or GSP: 

The existing SYS 1. FORTLIB must be scratched and uncataloged. 

The new SYS 1. FORTLIB must be cataloged in the generating system and 
the receiving system. 
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If the generating system is the one being modified: 

The existing SYS1.F0RTLIB may be recataloged and moved to another 
volume. 

The new SYS1.FORTLIB must be allocated space but it cannot be 
cataloged. 



Name 



Operation Operand 

FORTLIB For Design Level E 

DESIGNEE 

[UNIT=name 1 
VOLNO=serial| 
[UNTABLE=number] 
[OBJERR=unit] 

For Design Level G and H 



DESIGN= IGI 

ONIT=name 
VOLNO=serial_ 
\ ONTABLE=number ] 
OBJERR=unit ] 
ONLNRD=unit] 
ONLNPCH=unit] 

boundry= ( align |"| 
InoalignIJ 
opterr- iexclddei] 
(include I J 
; ADDNTRY=number ] 



ADDNTRY= (For G or H) 

specifies the number of option table entries to be generated in addition 
to the required number. 

number 

is a decimal number from to 598. 

Default; If this parameter is omitted, a value of is assumed. 

Notes: 



• Size: The option table has an 8-byte entry for each IBM- designated error 
condition. An additional 8-byte entry should be added for each installation 
error condition. 

• Required: This parameter is valid if and only if OPTERR=INCL0DE is 
specified. 

• For further information on option table entries, refer to the publication 
OS FORTRAN IV (G and HI Programmer's Guide. 

BO0NDRY= (For G or H) 

specifies the inclusion of the execution time boundary alignment routine 
in SYS1.LINKLIB. 
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ALIGN 

specifies that the routine is provided. 

NOALIGN 

specifies that the routine is not provided. 

Default: If this keyword parameter is omitted, ALIGN is assumed. 

Note; 

Model 91: NOALIGN must be specified if MODEL-91 is coded in the CENPROCS macro 
instruction. 

DESIGN^ 

specifies the design level of the FORTRAN subroutine library. 

E 

is the E-design level. 
G 

is the G-design level. 
H 

is the H-design level. 

Note: 



Model 91; Design-level E must not be specified if M0DEL=9 1 is specified in 
the CENPROCS Macro Instruction 

OBJERR= (For all design levels) 

specifies which FORTRAN logical I/O unit is to be used for object time 
error messages and FORTRAN dumps. 

unit 

is a two-digit decimal number. 

Default: If this keyword parameter is omitted, a value of 06 is assumed. 

Notes: 

• Value; The number cannot exceed the value given to UNTABLE, and cannot 
be the same as the value given to ONLNRD or to ONLNPCH. 

• Recommended: It is recommended that when using the E-design-level library, 
OBJERR=03 be specified to avoid the allocation of an additional output 
device. 

ONLNPCH= (For G or H) 

specifies which FORTRAN logical I/O unit is to be used when the PUNCH 
(online) statement is encountered. 

unit 

is a two-digit decimal number. 

Default: If this keyword parameter is omitted, a value of 07 is assumed. 




Notes: 



Value: The number cannot exceed the value given to UNTABLE, and cannot 
be the same as the value given to OBJERR or to ONLNRD. 
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• Cataloged Procedures: The FORTRAN G and H cataloged procedures assume 
logical I/O units 06, 05, and 07 as the OBJERR, ONLNRD, and ONLNPCH units, 
respectively. If a different value is given to any of those parameters, 
the cataloged procedures must be modified, as described in OS FORTRAN IV 
(G and H) Programmer's Guide. 

ONLNRD= (For G or H) 

specifies which FORTRAN logical I/O unit is to be used when the READ 
(online) statement is encountered in a FORTRAN source program. 

unit 

is a two-digit decimal number. 

Default: If the ONLNRD parameter is omitted, a value of 05 is assumed. 

Note: 

• Value: The number must not exceed the value given to UNTABLE, and cannot 
be the same as the value given to OBJERR or to ONLNPCH. 

OPTERR= (For G or H) 

. specifies the type of object-time error message to be generated. 

EXCLUDE 

specifies minimum error service and the termination of the job if 
an object-time error is detected. 

INCLUDE 

specifies complete error service and the possibility that a job may 
continue after an object-time error is detected (dynamic and default 
control is provided for each error condition) . 

Default: If this keyword parameter is omitted, EXCLUDE is assumed. 

UNIT- (For all design levels) 

specifies the direct-access device that will hold the volume on which 
SYS1.FORTLIB will be generated. 

name 

is the device type of a direct-access device that exists in the 
generating system. 

• Default: if the UNIT and VOLNO keyword parameters are omitted, the FORTRAN 
subroutine library is placed on the new system-residence volume. 

Note: 

• Required: If UNIT is specified, VOLNO must be coded. 

VOLNO= (For all design levels) 

specifies the volume that is to contain SIS1 .FORTLIB. 

serial 

is the serial number of the volume. 

• Default: If the UNIT and VOLNO keyword parameters are omitted, the FORTRAN 
subroutine library is placed on the new system-residence volume. 
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Notes: 



• Value; The value specified must be the same as the value given to the 
VOLUME keyword of the DD statement used to allocate space for SYS1.F0RTLIB 
during the preparation for system generation. 

• Reguired: If VOLNO is specified, UNIT must be coded. 

UNTABLE= (For all design levels) 

specifies the number of FORTRAN logical I/O units to be used at object 
time. 

number 

is a two-digit integer from 08 to 99. 

Default: If this parameter is omitted, a value of 08 is assumed. 

Note: 

Value: This number does not necessarily correspond to the number of I/O devices 
in the installation. 

Coding Hints and Additional Information 

The graphic subroutine package (GSP) for FORTRAN IV is specified by the GRAPHICS 
macro instruction. 

Detailed information about FORTRAN IV library subroutines can be found in the 
following publications: 

OS FORTRAN IV Library 

OS FORTRAN IV Library: Mathematical and Service Subprograms 

The chart below shows the relationship between the parameters of this macro 
instruction. 



Parameter 

I/O unit specified in; 
OBJERR must be 



ONLNRD must be 



ONLNPCH must be 



Commen 


t Parameter 




I/O unit specified in 


< 


UNTABLE 


# 


ONLNRD 


* 


ONLNPCH 


< 


UNTABLE 


* 


OBJERR 


# 


ONLNPCH 


< 


UNTABLE 


* 


OBJERR 


* 


ONLNRD 




IF OPTERR=INCLUDE 



then ADDNTRY can be coded. 



System Generation Macro Instructions 299 



Example: The following example illustrates the use of the FORTLIB macro 
instruction to specify the inclusion of the FORTRAN G subroutine library in 
the new operating system. The unit name is 2301. The volume serial number 
is 333555. Thirty-two logical units are to be used by the object time load 
modules. The third unit is to be used for error messages and FORTRAN dumps. 
Minimum error services are to be provided. 

FORTLIB ONIT=2301,VOLNO=333555,UNTABLE=32,OBJERR=03,DESIGN=G 
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FORTRAN 



The FORTRAN macro instruction specifies the inclusion of the FORTRAN compiler. 
This macro instruction is optional. 

Basic Requirements 

• INSTSET=SCNTF or UNI? must be specified in the CENPROCS macro instruction. 
The scientific or the universal instruction set is required for FORTRAN 
compilation as well as executions. 

• This macro instruction must be specified once for each design level to 
be generated. 

• MVT (including M65MP) Systems: If IBM-supplied cataloged procedures are 
to be used and the F128 linkage editor is included in the system, the 
REGION parameter in the cataloged procedures with link-edit steps must 
be changed. This alias for the linkage editor, IEWL, is given to the 
linkage editor included in the system, unless more than one is specified, 
in which case the alias is given to the largest. To change the parameter, 
use the IEBUPDTE utility program. Information about region sizes is 
provided in OS Storage Estimates. 

Processor/Library Generation 

• Sufficient space for the new FORTRAN compiler must have been allocated 
in SIS1.LINKLIB. 

• A previously generated FORTRAN compiler can be respecified. 

• In order to regain space occupied by previously generated compilers, use 
the IEBCOPY utility program. 



Name 



Operation 
FORTRAN 



Operand 

For FORTRAN G 



DESIGN=G 
PUNCH* I NODECK l] 
I DECK IJ 
SORLIST= 



STORMAP* 



SOURCE 11 



NOSOURCElJ 
NOMAP l" 
HAP I 




OBJPROG= [ LOAD 

I NOLO AD 
SORCODE= I EBCDIC 
I BCD 

[LINECNT=number] 
OBJLIST= j NOLI ST I] 
JLIST I I 
[-OBJID= INOIDI] 
ilD 11 
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Name 



Operation 

FORTRAN 
(Cont.) 



Operand 

For FORTRAN H 

DESIGN=H 
PUNCH= i NODECK ll 

Ideck IJ 

SORLIST= [ SOURCE l" 

InosourceL 

STORMAP= I NOMAP l' 

IMAP j. 
OBJ < PROG= [ LOAD 

INOLOAD 
SORCODE= [ EBCDIC 

IBCD 
LINECNT=number ] 
' SIZE=size] 
OBJLIST= INOLISTI"] 

ILIST IJ 
rOBJID= jNOipil 



OPT= 



llD 
OH 



1 

2]J 
SOREDIT= 

; SORXREF= 



NOEDIT 



EDIT 
NOXREF 



XREF 



DESIGN= 

specifies the design level of the FORTRAN compiler. 



is the G- design level, 
is the H-design level. 



Note: 



FORTRAN H: The FORTRAN H compiler can operate only with a central processing 
unit that has at least 256K bytes of main storage. 

The following keyword parameters provide the default options for the various 
options that can affect a FORTRAN compilation* Default options are the options 
that are assumed if the corresponding values of the PARM keyword are omitted 
from an EXEC statement in a FORTRAN compilation. 

LINECNT= (For G or H) 

specifies the number of lines to be printed on each page of the FORTRAN 
output listing. 

number 

is a two-digit integer from 01 to 99. 

Default: If this keyword parameter is omitted, a value of 50 is assumed. 

OBJID= (For G or H) 

specifies the assignment of internal statement numbers to calls and function 
references. 
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ID 

specifies that statement numbers are to be assigned. 

NOID 

specifies that statement numbers are not to be assigned. 

Default: If this keyword parameter is omitted, NOID is assumed. 

OBJLIST= (For G or H) 

specifies the production of a pseudo-assembly listing of the direct program, 

LIST 

specifies that the listing is to be produced. 

NOLIST 

specifies that the listing is not to be produced. 

Default: If this keyword parameter is omitted, NOLIST is assumed. 

OBJPROG= (For G or H) 

specifies the production of input to the linkage editor from the program 
being compiled. 

LOAD 

specifies that the source program is to be processed by the linkage 
editor after compilation. 

NOLOAD 

specifies that the source program is only to be compiled. 

Default: If this keyword parameter is omitted, LOAD is assumed. 

0PT= (For H) 

specifies how the optimization of the execution time of the object modules 
produced by the FORTRAN H compiler is to be done. 



specifies that the object module is not to be optimized. 

1 

specifies that it is to receive full register assignment and basic 
program optimization. 

2 

specifies that it is to receive full register assignment and complete 
program optimization. 

Default: If this keyword parameter is omitted, is assumed. 

PONCH= (For G or H) 

specifies the production of a punched deck of the object program. 

DECK 

specifies that a punched deck is to be produced. 

NODECK 

specifies that a punched deck is not to be produced. 

Default: If this keyword parameter is omitted, NODECK is assumed. 
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SIZE= (For H) 

specifies the amount of main storage available to the FORTRAN H compiler, 
exclusive of the storage reguired for buffers and system use. 

size 

is an integer from 153600 to 9999999, or it may be specified as nnnnK, 
where nnnn is an integer from 150 to 9999 and K represents 1024 bytes. 

Default: If this keyword parameter is omitted, a value of 204800 is assumed. 

Notes: 

• Ose: The value specified determines the size of three compiler tables 
whose size cannot be specified at execution time. The size of all the 
dictionary and text areas for the compiler is determined at execution time. 

• Value: The value specified should be the largest amount of main storage 
that would ever be needed by the FORTRAN H compiler, exclusive of the 
storage reguired for buffers and system use. 

• Information: For further information about this keyword parameter, see 
OS FORTRAN IV fG and H) Programmer 1 s Guide. 

SORCODE= (For G or H) 

specifies the character set used to keypunch the source programs to be 
compiled. 

BCD 

specifies the BCD character set. 

EBCDIC 

specifies the EBCDIC character set. 

Default: If this keyword parameter is omitted, EBCDIC is assumed. 

SOREDIT= (For H) 

specifies the production of a structured source listing in the data set 
defined by the SYSPRINT DD statement. 

EDIT 

specifies that the listing is to be produced. 

Note: 

Reguired: If this subparameter is specified, OPT=2 must be specified. 

NOEDIT 

specifies that the listing is not to be produced. 

Default: If this keyword parameter is omitted, NOEDIT is assumed. 

Note: 



• Use: This listing indicates the loop structure and the logical continuity 
of the source program. 
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SORLIST= (For G or H) 

specifies the production of a listing of the FORTRAN source program. 

SOURCE 

specifies that the listing is to be produced. 

NOSOORCE 

specifies that the listing is not to be produced. 

Default: If this keyword parameter is omitted, SOURCE is assumedi 

SORXREF= (For H) 

specifies the production of a cross-reference listing in the data set 
defined by the SYSPRINT DD statement. 



XREF 



specifies that the listing is to be produced. 



NOXREF 

specifies that the lasting is not to be produced. 

Default: If this keyword parameter is omitted, NOXREF is assumed. 

STORMAP= (For G or H) 

specifies the production of a map showing the relative locations of 
variables, constants, etc., in the source program. 



MAP 



specifies that the map is to be produced. 



NOMAP 

specifies that the map is not to be produced. 

Default: If this keyword parameter is omitted, NOMAP is assumed. 
Coding Hints and Additional Information 



Syntax Checker: The syntax checking routines for this compiler can be included 
in the system by use of the CHECKER macro instruction. 

Chart: The chart below shows the relationship between the parameters of this 
macro instruction. 



Parameter 



If SOREDIT=EDIT 



Comment 

then 

must be coded 



Parameter 



0PT=2 
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Example; The following example illustrates the use of the FORTRAN macro 
instruction to specify a G-design level FORTRAN compiler. The BCD character 
set is to be the default character set option at compilation time. Unless 
otherwise specified at compilation time, a FORTRAN source program listing is 
to be produced, and compiled source programs are to be processed by the linkage 
editor. Punched decks and source program maps of variables, constants, etc., 
are not to be produced. 

FORTRAN DESIGN=G,SORCODE=BCD 
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GENERATE 

The GENERATE macro instruction specifies the data sets, volumes, and I/O devices 
required for the system generation process, the system generation output 
options, and the type of generation being performed. This macro instruction 
is required for non-TSO generations; it must never be used in a TSO generation. 

Basic Requirements 

• The GENERATE macro instruction must be the last system generation macro 
instruction in your input deck and must immediately be followed by an 
assembler END statement. 

• The sequential data sets specified in the 0T1SDS, 0T2SDS, UT3SDS, and 
0T4SDS keyword parameters must be cataloged in the generating system. 

• The data set specified in the UT3SDS keyword parameter is used by the 
linkage editor and must be on a direct-access device. 

• The data specified by the UT4SDS keyword parameter is used by the IEBCOPY 
utility program and must reside on a direct-access volume. 

• If the data sets specified in the UT1SDS and 0T2SDS keyword parameters 
are to reside on magnetic tape, standard labels (SL) or no labels (NL) 
must be specified when the data sets are defined. (See "Input Deck For 
System Generation" in the "Preparation for System Generation" section.) 

• The data set specified in the OBJPDS keyword parameter must be a cataloged 
partitioned data set in the generating system. 

• If DTDISP=DELETE is specified, the data sets specified in the 0T1SDS and 
UT2SDS keyword parameters are uncataloged and deleted after the Stage II 
assemblies, and the data set specified in the 0T3SDS and UT4SDS keyword 
parameters is uncataloged and deleted after the Stage II IEBCOPY steps. 
(See "The Job Stream" section.) 

• The UTDISP keyword parameter refers only to the disposition of the four 
sequential data sets specified in the DT1SDS, 0T2SDS, 0T3SDS, and 0T4SDS 
keyword parameters after they are used during Stage II. It does not refer 
to the DISP keyword parameter of the DD statements used for these data 
sets in the input deck for system generation. 
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GENERATE 



The serial number specified in the RESVOL keyword parameter cannot be the 
serial number of the system-residence volume of the generating system. 

The serial number specified in the LNKVOL keyword parameter cannot be the 
serial number of the SYS1.LINKLIB of the generating system. 
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Nucleus Generation 

• The machine configuration and type of control program cannot be changed. 

• Additional resident functions cannot be made transient, 

• Transient functions can be made resident. 

• For the RESNAME, RESVOL, and HESTYPE keyword parameters, the unit name, 
serial number, and device type must be the same as the system-residence 
volume of the system being modified, which could be the generating system. 

• There must be enough space on the system-residence volume for the new 
member. 

• For the LNKNAME and LNKVOL keyword parameters, the unit name, 

serial number, and size must be the same as those of the SYS1 .LINKLIB of 
the system being modified. 

Processor/Library Generation 

• There must be sufficient space on the data sets for the new processor (s) 
and/or libraries. 

• For the RESNAME, RESVOL, and RESTYPE keyword parameters, the unit name, 
serial number, and device type must be the same as those of the system- 
residence volume of the system being modified, which could be the generating 
system. 

• For the LNKNAME and LNKVOL keyword parameters, the unit name, 

serial number, and size must be the same as those of the SYS1. LINKLIB of 
the system being modified, which could be the generating system. 

• Members may be added to existing libraries if sufficient space is available. 
If not, then a new data set must be created or the old one must be 
reallocated. (See the "Reallocating Data Sets" section.) 

I/O Device Generation 

• The system being modified cannot be the generating system. 

• The serial number specified in the RESVOL keyword parameter cannot be the 
volume serial number of the system-residence volume of the generating 
system. 

• The serial number specified in the LNKVOL keyword parameter cannot be the 
serial number of the SYS 1. LINKLIB of the generating system. 
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Fame 



Operation 

GENERATE 



Operand 

For Complete or Processor 



}] 



rGENTYPE=/ALL 

L \PROCESSOR 

0BJPDS=SYS1.name 

UT 1 SDS= (SYS 1 . name /, SL\) 

\,NLj 
0T2SDS= (SYS 1 . name j,SL\) 

IrNL/ 
UT3SDS=SYSl.name 
UT4SDS=SYS1.name 

{ KEEP V 
UNCATLGf 
DELETE ) : 
'2301 
i2303 
RESTYPE= F2305-1 
,2305-2 
311 



J 



330 
RESNAME=name 
RESVOL=serial 

LNKNAME=name 

LNKVOL=seria 

ASMPRT=J0FFl"| 

LEPRT= (optionf , option ]) ] 
INDEX=/ SYS1 V] 
inamefj 
[SYOUTDV=(name,n) ] 

{CATALOGj- 
VTOC > 
PDS ). 

JOBSTMT= i NOTSUPPLIEP n 
\SOPPLIED f] 

For Nucleus 

GENTYPE= (NUCLEUS, n) 
OB JPDS=SYS 1 . name 
UT1SDS=(SYS1.name f,SL\) 

t,NLf 
UT2SDS= (SYS 1. name /,SL\) 

\,nl; 

UT3SDS=SYS1.name 
UT4SDS=SYSl.name 

{ KEEP ) 
UNCATLG> 
DELETE J 
r 2301 
2303 
RESTYPE= J 2305- II 
2305-2J 

±1 
14 

3330 

RESNAHE-name 
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Name 



Operation 



Operand 



GENERATE 
(Cont.) 



For Nucleus (continued) 

RESVOL=serial 
|~LNKNAME=name "I 
LLNKVOL=serialJ 

|~ASMPRT= J0FF)~1 

' LEPRT= (option[ r option ]) ] 
INDEX = J SYS1 \~| 
(name) J 
k SYOUTDV=fname,n) ] 
" JOBSTMT= / NOT SUPPLIED !"] 
(SUPPLIED /J 

For I/O Device 

GENTYPE=(IO,n) 
OBJPDS=SYS1.name 
UTlSDS=(SYS1.name /,SL)) 

l,NL/ 
UT2SDS= (SYS 1. name /,SLt) 

l,NLj 
UT3SDS=SYS1.name 
UT4SDS=SYS1.name 
r ( KEEP )-i 

I UTDISP=/UNCATLG> 
(DELETE ). 
/230 1 
12303 
RESTYPE= 12305-1 
{2305-2 
12311 

V3330 
RESNAHE=name 
RESVOL=serial 
[LNKNAME=name 1 
I LNKVOL=serial| 
ASMPRT=/OFF)"| 

\oTrjJ 

■ LEPRT= (option[ , option ]) ] 
INDEX=/ SYS1 \"[ 
(name | J 
" SYOUTDV=(name r n) ] 

{CATALOG)"] 
VTOC > 

LOGREC-/ NOPRINT V\ 
|PRINT (J 
JOBSTMT= /NOTSUPPLIED n 
(SUPPLIED fj 
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ASMPRT= (For all types) 

specifies whether assembly listings are to be produced for the modules 
assembled during system generation. 

ON 

specifies that assembly listings are to be generated. 

OFF 

specifies that assembly listings are not to be generated. 

Default; If this keyword parameter is omitted, OFF is assumed. 

DIRDATA= (For Complete, Processor, or I/O Device) 

specifies the system directory data for the new system is to be printed 
during system generation as one of the following: 

For ALL or PROCESSOR generations: 

CATALOG 

specifies that the catalog of the new system is to be printed. 

VTOC 

specifies that the volume table of contents (VTOC) of each volume 

in the new system is to be printed. The catalog is also to be printed. 

PDS 

specifies that the directories of all partitioned data sets in the 
new system are to be printed. The VTOCs and the catalog are also 
to be printed. 

For I/O Generation: 

CATALOG 

specifies that the system catalog will be printed unchanged. 

VTOC 

specifies that the system catalog and the volume table of contents 
of the volume where SYS1.LINKLIB and SYS1.SVCLIB reside will be 
printed. 

PDS 

specifies that the contents of SYS1.LINKLIB and SYS1.SVCLIB will be 
printed. The functions of VTOC will also be provided. 

Default: If this keyword parameter is omitted, no system directory data is 
printed. 

GENTYPE= 

specifies the type of system generation. (See Figure 79 in the "System 
Generation Macro Instructions" section.) 

ALL 

specifies that a complete system is to be generated. 

NUCLEUS, n 

specifies that only a nucleus is to be generated. 

n 

is a decimal number from 1 to 9 that will be used to identify 
a new member of SYS 1. NUCLEUS. The member name will be IEANUCOn. 

Value: The value 1 is always assigned to the nucleus generated when 
ALL is specified. Therefore, if 1 is specified in this subparameter, 
the new nucleus generated replaces the nucleus generated during a 
complete system generation. 
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PROCESSOR 

specifies that only language processors and libraries are to be 
generated. 

10, n 

specifies that the machine configuration will be modified. 

n 

is a decimal number from 1 to 9. 

Note: 

Value: This number is the last character of the name of the nucleus to 

be modified. For example, if the value 1 is specified, the primary nucleus 

will be modified. 

Default: If this keyword parameter is omitted, ALL is assumed. 

INDEX= (For all types) 

specifies the gualifier for the new system data sets that will be created 
during system generation. 

SYS1 

is a gualifier. 

name 

is a gualifier that can be from one to eight alphameric characters; 
the first one must be alphabetic. 

Note: 

The new system data sets that can be defined with the user-assigned 
qualifier are: ALGLIB, ASRLIB, COBLIB, CMDLIB, DCMLIB, FORTLIB, LINKLIB, 
LOGREC, MACLIB, NUCLEUS, PARMLIB, PL1LIB, PROCLIB, SORTLIB, SVCLIB, 
TELCMLIB, and IMAGELIB. 

If other than INDEX=SYS1 is specified, data sets SYS1. COBLIB, 
SYS1. FORTLIB, SYS 1 .MACLIB, SYS1 .PARMLIB, SYS1 .PROCLIB, and 
SYS1.S0RTLIB on the generating system must be changed to 
SYS1 .DCOBLIB, SYS1 .DFORTLIB, etc. using the RENAME function 
of utility IEHPROGM. An alternate method is to use the IBM 
supplied jobs CTLG2311, CTLG2314, or CTLG3330 in SYS1.SAMPLIB 
on the DLIBOX pack. 

Default: If this keyword parameter is omitted, SYS1 is assumed. 

J0BSTMT= (For all types) „„«^ m 

specifies whether your own JOB statement for Stage II of the system 
generation process will be put in the system generation input deck. 

NOTSOPPLIED . .,,,„„* Aa „ v 

specifies that your own JOB statement will not be m the input decK. 

SUPPLIED 

specifies that you will supply in the input deck a JOB statement to 

be used for Stage II. 

Defaults: 

• if this keyword parameter is omitted, NOTSUPPLIED is assumed. 

• if this keyword parameter is omitted or NOTSOPPLIED is coded, the following 
JOB statement will be used: 

//SYSGEN JOB 1,» SYSTEM GENERATION' 
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Notes; 

• Required Placement; Your JOB statement must be before the GENERATE macro 
instruction but after any global SET statements. You must place a REPRO 
statement immediately preceding the JOB statement. For each continuation 
line for the JOB statement, there must also be a REPRO statement preceding 
each continuation statement. (For detailed information about the REPRO 
statement, see OS Assembler Language. ) 

• DP Statement; When SUPPLIED is specified, then the SYSIN DD statement 
that precedes the system generation macro instructions in the input deck 
must be //SYSIN DD DATA. A //SYSIN DD * statement cannot be used, because 
it causes the JOB statement following the REPRO statement to be scheduled 
as a new job. 

LEPRT= (For all types) 

specifies linkage editor print options as one or two of the following 
values. 

LIST 

specifies that the list of control statements is to be in card-image 
format. 

HAP 



XREF 



specifies that a module map will be produced. 

specifies that a cross-reference table will be produced. (XREF 
includes the MAP option) . 

Default: If this keyword parameter is omitted, only linkage editor error 
messages, if any, are printed. For a more detailed description of these 
options, see the publication QS Linkage Editor and Loader. 
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LNKNAME= (For all types) 

specifies a direct-access device in the generating system. 

name 

is the device type. 

Default: If LNKNAME and LNKVOL are omitted, the link library is placed on 
the new system-residence volume. 

Notes: 



• Use; The volume on this device will contain the link library. 

• Coding: If LNKNAME is specified, then LNKVOL must also be coded. 

LNKVOL= (For all types) 

specifies the volume that will contain the link library. 

serial 

is the serial number. 

Default: If LNKNAME and LNKVOL are omitted, the link library is placed on 
the new system-residence volume. 

Notes: 

• Required: The value specified must be the same as the value given to the 
VOLUME keyword parameter of the DD statement used to allocate space for 
SYS1.LINKLIB during the preparation for system generation. 

• Coding: If LNKVOL is specified, then LNKNAME must also be coded. 

LOGREC= (For I/O Device) 

specifies whether or not the contents of the data set SYS1.L0GREC will 
be printed before it is scratched during an I/O device generation. 

NOPRINT 

specifies that the contents of SYS1.L0GREC will not be printed. 

Note: If this subparameter is specified, you must print the SYS1.L0GREC 
data set to save any necessary information. 

PRINT 

specifies that the contents of SYS1.L0GREC of the old system will 
be printed. 

Note: This subparameter can be used only if the generating system is of 
Release 17 level or later. 

Default: If this keyword parameter is omitted, NOPRINT is assumed. 

OBJPDS= (For all types) 

specifies the partitioned data set to be used for the storage of object 
modules assembled during system generation. 

SYSI.name 

is the lowest-category simple name of the partitioned data set. 

Note: 

This data set must exist as a cataloged partitioned data set in the generating 
system. 
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RESNAME= (For all types) 

specifies a direct-access device in the generating system. 

name 

is the unit address, device type, or group name for the new system- 
residence volume. 

Note: 



The volume on this device will contain the new system-residence volume. 

RESTYPE= (For all types) 

specifies the device type of the new system-residence device as 2311, 2301, 
2303, 2305-1, 2305-2, 2314, or 3330. 

Default: If this keyword parameter is omitted, 2311 is assumed. 

RESVOL= (For all types) 

specifies the serial number of the new system-residence volume. 

serial 

is the serial number. 

Note: 

Required: The value specified must be the same as the value given to the 
VOLUME keyword parameter of the DD statement used to allocate space for 
SYS 1. NUCLEUS during the preparation for system generation. 

SY0UTDV= (For MFT or MVT including M65MP) 

specifies the direct-access devices to be used for Stage II output data 
sets (SYSPRINT) during a generation. Device types are described in Appendix 
A. 

name 

is the device type, 
n 

specifies the number of volumes that may be occupied by the data set. 

Default: If this keyword parameter is omitted, SYSOUT=A is assumed. 
Note: 



A generation under MFT or MVT (including M65MP) will need about 2500 tracks 
on a 231 1. 



GENERATF 
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OTDISP- (For all types) 

specifies disposition information for the four sequential data sets used 
during system generation. 

KEEP 

specifies that the data sets are to remain cataloged in the generating 
system. The space they occupy is to remain allocated to them. 

UNCATLG 

specifies that catalog entries for the data sets are to be removed 
from the index structure. Those data sets on direct-access devices 
remain tabulated in the YTOC. 

DELETE 

specifies that the data sets are to be uncataloged and the space 
allocated to them is to be released. 

Default: If this keyword parameter is omitted, KEEP is assumed. 

UT1SDS= 

0T2SDS= (For all types) 

UT3SDS= 

0T4SDS= 

these parameters specify the names of the sequential data sets to be used 
during system generation by the assembler, linkage editor, and utilities. 

Default: For UT1SDS and UT2SDS, standard data set labels are assumed. 

Note: 

These data sets must exist as cataloged data sets in the generating system. 

Coding Hints and Additional Information 

Example; The following example illustrates the use of the GENERATE macro 
instruction to specify the generation of an operating system. The sequential 
data sets named SYS1.UTIL1, SYS1.UTIL2, SYS1.UTIL3, and SYS1.UTIL4 are used 
during system generation by the assembler, linkage editor, and utilities. 
SYS1.UTIL3 and SYS1.UTIL4 reside on a direct-access volume. SYSl.UTILl, 
SYS1.UTIL2, SYS1.UTIL3, and SYS1.UTIL4 are to remain 1 cataloged and are to be 
allocated space in the generating system after Stage II. 

SYS1.0BJM0D is the name of the partitioned data set to be used for the storage 
of load modules assembled during system generation. The unit name of the new 
system-residence device is 190, the device type is 2311, and the serial number 
of the system-residence volume is SYSTEM. Assembly listings, linkage editor 
printed output, and system directory data are not to be produced. The link 
library is to be placed on the system-residence volume. 



GENERATE UT1SDS=SYS 1 . UTIL1 ,0T2SDS=SYS 1 . 0TIL2,UT3SDS=SYS 1. UTIL3, 
UT4SDS=SYS1.UTIL4,OBJPDS=SYS1.OBJMOD,RESNAME=190, 
RESTYPE=231 1 ,RESVOL=SYSTEM 

Diagnostic Override : The diagnostic override procedure is described in 
Appendix F. 
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GENTSO 

The GENTSO macro instruction specifies the data sets, volume, and I/O devices 
required for a TSO system generation. It also specifies the system generation 
output options and the type of generation being performed. 

This macro instruction must be used instead of the GENERATE macro instruction 
when a TSO system is generated or modified. See the "Time Sharing Option 
(TSO) " discussion in the "Program Options Descriptions" section for TSO coding 
requirements. 

The macro instruction has the same parameters and requirements as the GENERATE 
macro instruction. In addition, it has two parameters that GENERATE does not 
have: 

Name Operation Operand 

GENTSO |"CMDNAME=name 1 

|_CMDVOL=serialJ 
See GENERATE for the other parameters. 



CMDNAME= (For Complete or Processor) 

specifies a direct-access device in the generating system. The volume 
of this device will contain the SYS1. CMDLIB. 

name 

is the device type. 

Default: If the CMDLIB macro instruction is specified and CMDNAME and CMDVOL 
are not specified, SYS1. CMDLIB is placed on the new system-residence volume. 

Notes: 

• Required: Both CMDNAME and CHDVOL keyword parameters must be coded if 
either is specified. 

• The CMDLIB macro must be specified if CMDNAME and CMDVOL are specified. 

CMDVOL= (For Complete or Processor) 

specifies the volume that is to contain the SYS1. CMDLIB data set. 

serial 

is a serial number. 

Default and Notes: See CHDNAME. 
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GJOBCTL 

The GJOBCTL macro instruction specifies the inclusion of the graphic job 
processor (GJP) and/or the satellite graphic job processor (SGJP) . GJP enables 
jobs to be defined and initiated from IBM 2250 Display Units. SGJP enables 
jobs to be defined and initiated from remote 1130/2250 graphic subsystems. 
This macro instruction is optional. 

Basic Requirements 

• The GRAPHICS macro instruction must be specified. 

• A set of cataloged procedures is required for GJP and SGJP. These cataloged 
procedures can be added to SYS1.PKOCLIB before or after system generation 

by use of the IEBUPDTE utility program. The cataloged procedures required 
and the method for adding them to either library are described in OS HFT 
Guide and OS MVT Guide. 

• All the keyword parameters can be specified for any type. 
I/O Device Generation 

• This macro instruction cannot be specified if it was not specified in the 
last complete system generation. 

• This macro instruction may be specified to change the addresses specified 
in the UNITS parameter. The addresses originally generated will remain 
unchanged if this macro instruction is not specified. 



Name 



Operation 
GJOBCTL 



Operand 



TYPE= <SGJP > 

((GJP, SGJP) J J 



GJP 

SGJP 

(GJP, SGJP) 
UNITS= (address[ , address ]. . .) 
SYSOUT= (classname* ,classname 2 ,classname 3 , 

classname*) 
CLASS= (jobclass 1 , jobclass 2 [ , jobclass* ]) 
PRI= (priority* , priority 2 ) 
[ REGION* ([ number* ][ , number 2 ][ , number* ]) ] 
[ ALLOC= ([ number * ][ , number 2 ]) ] 
[UNITREF=name] 
[LINEREF=name] 
[LINE=number ] 
[DAPOOL-name] 




ALLOC= 

specifies the number of tracks for the primary and secondary allocations 
for a new data set (allocated if the SYSTEM ALLOCATE option is specified 
in a DESCRIBE DATA frame) . 

number 1 

is an integer from 1 to 9999« It is the first positional subparameter, 
and specifies the number of tracks for primary allocation. 

Default: If this subparameter is omitted, a value of 20 is assumed. 
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number2 

is an integer from 1 to 9999. It is the second positional 
subparameter, and specifies the number of tracks for secondary 
allocation. 

Default: If this subparameter is omitted, a value of 5 is assumed. 

CLASS= 

specifies the job classes to be used by GJP or SGJP and by jobs defined 
by GJP or SGJP operations. 

jobclassl 

is the first positional subparameter. It specifies the job class 
for GJP or SGJP and for foreground jobs. 

jobclass2 

is the second positional subparameter. It specifies the job class 
of background jobs. 

jobclass3 

is the third positional subparameter. It specifies the job class 
of the initial processor in SGJP. 

Note: 

MFT: This subparameter can be specified only if TYPE=MFT is specified 
in the CTRLPROG macro instruction. 

Note: 

Value: Each value must be a letter from A through 0. 

DAP00L= 

specifies the name of a collection of direct-access devices that can be 
used for data sets if the user specifies the DIRECT ACCESS POOL option 
in a DESCRIBE DATA frame. 

name 

is a value that must be the same as the value given to the NAME keyword 
parameter of a UNITNAME macro instruction that defines a collection 
of direct-access devices. 

Default: If this keyword parameter is omitted, a value of SYSDA is assumed. 

LINE= 

specifies the maximum number of lines to be printed on each page of the 
PRINTED RECORD output listing. 

number 

is an integer from 10 to 99. 

Default: if this keyword parameter is omitted, a value of 50 is assumed. 

LINEREF= 

specifies the default option for the ddname that will be placed in an 
internally generated DD statement for an 1130/2250 subsystem when the user 
omits the SUBSYSTEM REFERENCE parameter during job definition. 

name 

is a value that cannot exceed eight alphameric characters, the first 
of which must be alphabetic. 

Default: If this keyword parameter is omitted, the name FT99F001 is assumed. 
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Note; 

LINEREF need be specified only if SGJP is specified with the TYPE keyword 
parameter. 

PRI= 

specifies the priorities to be assigned to jobs defined by GJP or SGJP 
operations. 

priorityl 

is the first positional subparameter. It specifies the priority of 
foreground jobs. 

priority2 

is the second positional subparameter. It specifies the priority 
of background jobs. 

Note: 

Value: Each value specified must be an integer from to 13. 

REGION= 

specifies the number of 1024-byte blocks of main storage required for the 
regions for GJP or SGJP and for jobs defined by GJP or SGJP operations. 

numberl 

is a decimal number from 1 to 999 that specifies the region size for 
GJP or SGJP. 

Note: This must be the first positional parameter. 

number2 

is a decimal number from 1 to 999 that specifies the region size 
foreground jobs. 

Default: If this subparameter is omitted, the value specified in the PARB 
keyword parameter of the EXEC statement for the reader/interpreter procedure 
used for the job is assumed. 

Note: This must be the second positional parameter. 

number3 

is a decimal number from 1 to 999 that specifies the region size of 
background jobs. 

Default: If this subparameter is omitted, the value specified in the PARM 
keyword parameter of the EXEC statement for the reader/interpreter procedure 
used for the job is assumed. 

Note: This must be the third positional parameter. 

Notes: 

• Value: Each value specified must be an integer from 1 to 999. 

• HVT (including M65MP) : The REGION parameter need be specified only if 
TYPE=MVT or M65HP is specified in the CTRLPROG macro instruction. 
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SYSOUT= 

specifies the four classnames to be used for system output from jobs defined 
by GJP or SGJP operations. 

classnamel 

is the first positional subparameter. It specifies the MSGCLASS for 
foreground jobs only. (This classname must not be used by any SYSOUT 
writer or other jobs while GJP or SGJP is in operation.) 

classname2 

is the second positional subparameter. It specifies the MSGCLASS 
for background jobs only. (This classname can be used for any other 
purpose.) 

classname3 

is the third positional subparameter. It specifies the print output 
class. (This classname can be used for print output by other jobs.) 

classname4 

is the fourth positional subparameter. It specifies the punch output 
class. (This classname can be used for punch output by other jobs.) 

Note: 

• Value: Each value specified must be a letter from A to Z or a number from 
through 9. 

TYPE= 

specifies the type of graphic job control to be included as one of the 
following: 

Value Processor 

GJP The graphic job processor (GJP) only is to be included. 

SGJP The satellite graphic job processor (SGJP) only is to be included. 

GJP r SGJP Both GJP and SGJP are to be included. 

Note: 



SGJP requires BTAM and processor-to-processor data transmission modules. BTAM 
is specified with the DATAMGT macro instruction; processor-to-processor modules 
are specified with the PTOP macro instruction. 

UNITREF= 

specifies the default option for the ddname that will be placed in an 
internally generated DD statement for a GJP foreground job when you omit 
the DISPLAY UNIT REFERENCE parameter in the SPECIFY JOB STEP frame. 

name 

is a value that cannot exceed eight alphameric characters; the first 
character must be alphabetic. 

Default: If this keyword parameter is omitted, the name SYSDSPLY is assumed. 

Note: 

Reguired: DNITREF need only be specified if GJP is specified with the TYPE 
keyword parameter. 
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ONITS= 

specifies a 2250 display unit that is to be used for GJP operations and/or 
1130/2250 subsystems to be used for SGJP operations. 

address 

is the address of a 2250 display unit. 

Notes; 

• Required; Four or five data sets must be cataloged and allocated space 
in the new system for each address specified with the UNITS keyword 
parameter. This function can be performed before or after system generation 
using the IEHPROGM utility program. The data sets and their allocations 
are described in OS MFT Guide and OS MVT Guide. 

• Maximum; A maximum of 15 addresses can be specified. Each address value 
must be the same as that specified for a device or telecommunications line 
in an IODEVICE macro instruction. 

Coding Hints and Additional Information 

The following example illustrates the use of the GJOBCTL macro instruction 
to specify the inclusion of the graphic job processor in an MVT operating 
system. The addresses of the 2250 units used are 106 and 206. X is the 
MSGCLASS for all foreground jobs, A is the MSGCLASS for all background jobs, 
A is the print class, and B is the punch class. Jobclass G is specified for 
each graphic job processor and each foreground job, and jobclass C is specified 
for background jobs. 

Priority 13 is assigned to foreground jobs and priority 5 to background jobs. 
The number of 1024-byte blocks of main storage required for each region are; 
60 for each graphic job processor region, 60 for each foreground job region, 
and 50 for each background job region. NEW data sets will be allocated 20 
tracks for primary allocation and 5 tracks for secondary allocation. Internally 
generated DD statements are to have the SYSDSPLY ddname. The collection of 
devices named SYSDA is to be used for direct-access data sets. A maximum of 
50 lines are to be printed on each page of the output listing. 

GJOBCTL TYPE=GJP,UNITS=(106,206) , SYS0UT= (X, A, A,B) ,CLA,SS= (G,C) , 
REGION=(,60,50) ,PRI= (13,5) 
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GRAPHICS 

The GRAPHICS macro instruction specifies the inclusion of graphic programming 
services. This macro instruction is optional. 

Basic Requirements 

• This macro instruction must be specified if the GJOBCTL macro instruction 
is specified. 

• If the 2250 Display Unit, Model 3 is specified in the SCHEDULR or SECONSLE 
macro instruction as an operator console, this macro instruction must be 
included in the input deck. 

Nucleus Generation 

• This macro instruction is included if the nucleus is to support graphic 
programming services. 

• If the new nucleus is to support the same set of graphic programming 
services that was included in the system during the last complete 
generation, then this macro instruction must be coded exactly the way it 
was specified in the last complete system generation. 

Processor/Library Generation 

• This macro instruction is included only if SYS1.FORTLIB (FORTLIB macro 
instruction) or SYS1.PL1LIB (PL1LIB macro instruction) are being replaced 
and graphic programming services was included in the last complete system 
generation. 

• Only GSP=INCLDDE has to be coded, if it is required, because the PORRTNS 
parameter is ignored. 

I/O Device Generation 

• The graphic programming services (GPS) cannot be added during this type 
of generation. 

• If graphics were specified during the last complete system generation, 
then they must be specified during this type of generation with exactly 
the same parameters and subparameters. 



GRAPHICS 
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Name Operation Operand 
GRAPHICS 



PORRTNS= ( INCLUDE )] 
(EXCLUDE/J 
GSP= { EXCLUDE )] 
) INCLUDE f J 



GSP= 

specifies the inclusion of the FORTRAN IV graphic subroutine package (GSP) 
in SYS1.LINKLIB and SYS1.F0RTLIB and/or SYS1.PL1LIB and/or SYS1.COBLIB. 

INCLUDE 

specifies that GSP is to be included. 

EXCLUDE 

specifies that GSP is not to be included. 

Default: If this keyword parameter is omitted, EXCLUDE is assumed. 

PORRTNS= 

specifies the inclusion of problem-oriented routines (PORs) in SYS1 .LINKLIB. 

INCLUDE 

specifies that PORs are to be included. 

EXCLUDE 

specifies that PORs are not to be included. 

Default: If this keyword parameter is omitted, INCLUDE is assumed. 

Coding Hints and Additional Information 

The information necessary to use the graphic programming services can be found 
in the following publications about the Operating System: 

OS GSP for FORTRAN IV, COBOL, and PL/1 

OS GPS for IBM 2250 Display Unit 

OS GPS for IBM 2260 Display Station (Local Attachment) 

OS GPS for IBM 2280 and 2282 Display Units 

Example: The following example illustrates the use of the GRAPHICS macro 
instruction to specify the inclusion of graphic programming services in the 
new operating system. Problem-oriented routines are to be included in 
SYS1. LINKLIB. GSP is not to be included. 

GRAPHICS 
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HELP 

The HELP macro instruction specifies the inclusion of the TSO SYS1.HELP data 
set in the new operating system. This macro instruction is optional and valid 
only in a complete or processor generation of a TSO system. 

Basic Requirement 

• Space must be allocated for SYS 1. HELP. The data set may be cataloged in 
the new system. 

Processor/Library Gen eration 

• This macro instruction can be used to add or replace a SYS 1. HELP data set. 
If an existing data set is to be replaced, it must be scratched and 
uncataloged before the new one is added. 



Name Operation Operand 



HELP [" UNIT=name 

LVOLNO=sseria: 



Default: If the UNIT and VOLNO keyword parameters are omitted, SYS1.HELP is 
placed on the new system-residence volume. 

ONIT= 

specifies a direct-access device in the generating system. The volume 
on this device will contain the SYS 1. HELP data set. 

name 

is the device type. 

Note: 



Required: If this keyword parameter is specified, VOLNO must also be 
coded. 

VOLNO= 

specifies the volume that is to contain the SYS1.HELP data set. 

serial 

is a serial number. 

Note: 

Required: If this keyword parameter is specified, UNIT must also be coded, 

Coding Hints and Additional Information 

This example illustrates the use of the HELP macro instruction to specify the 
inclusion of the TSO SYS1.HELP data set in the new operating system. The unit 
name is 2301 and the volume serial number is 43367. 

HELP UNIT=2301,VOLNO=43367 
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IMAGELIB 

The IMAGELIB macro instruction specifies the inclusion of the image library 
(SYS1. IMAGELIB) in the new operating system. 

Basic Requirements 

• This macro instruction is required if UNIT=1403 and FEATURE=UNVCHSET 
or if UNIT=3211 is specified in an IODEVICE macro instruction. 

• Space must be allocated for SYS 1. IMAGELIB. 

• SYS 1 .IMAGELIB must be a cataloged data set. 

I/O Device Generation 

• This macro instruction is required if UHIT=1403 and FEATURE=UNVCHSET 
or if UNIT-3211 is specified in an IODEVICE macro instruction. 

Name Operation Operand 

IMAGELIB ruNIT=name "J 
|_VOLNO=serialJ 

Default; If the UNIT and VOLNO keyword parameters are omitted, the image 
library is placed on the new system-residence volume. 

UNIT= 

specifies a direct-access device in the generating system that has the 
volume on which the image library is to be generated. 

name 

is the device type. 

Note: 

Required,; If this keyword parameter is specified, VOLNO must also be specified, 

VOLNO= 

specifies the volume that is to contain the image library. 



serial 

is the serial number. 



Notes: 



IMAGELIB 



• Value: The value specified must be the ssame as the value specified in 
the VOLUME keyword parameter of the DD statement used to allocate space 
for SYS1. IMAGELIB. 

• Required: If this keyword parameter is specified, ONIT must also be coded. 

Coding Hints and Additional Information 

This example illustrates the use of the IMAGELIB macro to specify the inclusion 
of the parameter library in the operating system to be generated. The unit 
name is 2314. The volume serial number is 333666. 

IMAGELIB UNIT=2314,VOLNO=333666 
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IOCONTRL 

The IOCONTRL macro instruction describes a control unit and its operating 
system requirements. This macro instruction is required. 

Basic Requirements 

• An IOCONTRL macro instruction is required for each control unit (listed 
in Figure 81) in the computing system. 

• Valid combinations for the UNIT, MODEL, and FEATURE keywords are shown 
in Figure 81, which follows the example for this macro instruction. 

• A maximum of forty IOCONTRL macro instructions can be specified during 

a system generation. If more are required, see Appendix B for the procedure 
to be followed. 

Nucleus Generation 



• Each IOCONTRL macro instruction specified during the last complete 
generation must be respecified and followed by the appropriate IODEVICE 
macro instruction (s) . 

I/O Device Generation 

• All I/O control units that are to be* in the new system must be specified 
with this macro instruction and followed by the appropriate IODEVICE macro 
instruction (s) . 

• The control units specified may be additions, deletions, changes, or the 
same as in the last complete system generation. 

Name Operation Operand 

[name] IOCONTRL DNIT=unit 

ADDRESS= address 
[ MODEL=model ] 
[FEATURE=(feature[ ,f eature ]. . .) ] 

For UNIT=2840 Only: 

[EXPBFR=number ] 



IOCONTRL 



Name Field: 

name 

is used in system generation error messages (see Appendix D| to identify 
any IOCONTRL macro instruction that produces an error. 
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Operand Field: 



ADDRESS= (For all units) 

specifies the address of the control unit. 

address 

is two hexadecimal digits with a value from 00 to DF. 

Notes: 



• Value: This value normally corresponds to the two high-order digits of 
the addresses of the devices attached to the control unit. If the high- 
order digits of the device addresses differ, the lowest value must be used. 
For example, if the addresses of the devices attached to the control unit 
are 00E and 010, the value given to the ADDRESS keyword of the IOCONTRL 
macro instruction must be 00. 

* Required: There must be only one IOCONTRL macro instruction for each 
control unit. The value given to the address must be the lowest address 

of the control unit. The other addresses must not be specified. Duplicate 
control unit addresses must not be specified for a 2848 graphic control 
unit. Duplicate control unit addresses may be specified for a 2840 graphic 
control unit attached to a selector subchannel. However, only one duplicate 
address is allowed, and the addresses of the devices attached to the control 
unit with the duplicate address might be eight or higher (for example, 
3D8, 3D9, 3DA, etc.) . 

EXPBFR= (For 2840) 

specifies that programs written for a 2250 Model 1, not using the DCB 
operand GTYPE=BASIC, can be used with a 2250 Model 2 or 3 attached to a 
2840. 

number 

is an integer from 1 to 8192. 

Default: If this keyword parameter is omitted, a value of 4096 is assumed. 

Note: 

The value specified is the amount of buffer space, in bytes, required by the 
programs. 
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FEATURE= (For any unit) 

specifies the optional features that are present on the control unit. 
These values can be written in any order. Features enclosed in braces 
{ } are mutually exclusive. 

feature 

is one of the following values: 



Value 



Feature 



ABSLTVEC 
ADSTORAG 
2-CHANSW 

ALTCTRL 



BUFFER8K 

COLBNRY 

DATACONV 

LINEADDR 

NODESCUR 

RECOFLO 

SHARED 

2-CHANSW 
7-TRACK 
16-DRIVE 
800BPI 



Absolute vector control on 2840 Model 1 

Additional storage on 2841 

2-channel switch on 2841 

Devices on a tape control unit attached to a matrix switch can be 

accessed through a different physical control unit. This can be 

specified only for an M65MP system. 

Additional 8K buffer on 2840 Model 1 

Column binary on 2821 Model 1, 4, or 5 

Data conversion 2403, 2404, 2803, or 2804 

Line addressing on 2848 

Non-destructive cursor on 2848 

Record overflow on 284 1 

All drives attached to 2820 or 2841 can be shared by two CPUs. SHARED 

requires 2-CHANSW. 

2-channel switch on 2820 

7-track compatibility on 2403, 2404, 2803, 2804, 3410, or 3803 

16-drive addressing on 2403 or 2803 

800 BPI on Model 4, 5, or 6 of 2403 or 2415, or on Model 2 of 2803, 

2804, 3410, or 3803 



Notes: 



I- 



M65MP; 2-CHANSW must be specified if TYPE=M65MP is specified in the 
CTRLPROG macro instruction. 

If a 3803 Model 1 control unit is specified, 7-track and 800BPI cannot 
be specified together. 

• If SHARED is specified, alternative channel addressing (see the OPTCHAN 
parameter of the IODEVICE macro instruction) cannot be specified for any 
of the direct-access devices attached to the 2820 or the 2841. 

MODEL= (For some units) 

specifies the model, if any, of the control unit. 



model 

is a value that can be 1, 2, 3, 4, 5, 6, 21, 22, or N1. 

0NIT= (For all units) 

specifies the control unit number. 



IOCONTRL 



unit 



is a number that can be 1051, 2403, 2404, 2415, 2701, 2702, 2703, 
2803, 2804, 2820, 2821, 2822, 2840, 2841, 2848, 3410, 3803, 3811, 
or 3272. 



Notes: 



The IBM 1052 printer keyboard is attached to Model 40 or above through 
an IBM 1052 adapter and not through a control unit. Thus, an IOCONTRL 
macro instruction is not needed in this case. 
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• 2816 or 2844 is implied through the specification of the OPTCHAN parameter 
in the IODEVICE macro instruction and need not be specified in any macro 
instruction. 

• If a 2260 is attached to a 2701 through a 2848, the 2848 is implied and 
must not be specified. 

• If a 2821 is attached to a multiplexor channel, the CE Panel Mode Switch 
of the 2821 should be set in the "2, 4 byte mode." It must not be set 
in the burst mode. 

• A 3411 is a 3410 tape drive and control unit. To use a 3411, specify 
ONIT-34 10. 

• Only model 1 devices (3277, 3284, 3286) may be connected to a 3272 model 

1 control unit. Either model 1 or model 2 devices or both may be connected 
to a 3272 model 2. 

• If a 2702 is specified, a dummy device should be specified for line so 
that your Program Systems Representative can run diagnostics programs. 

Coding Hints and Additional Information 

If no name is entered, the macro instruction supplies sequential identification 
numbers to the IOCONTRL macro instructions in the same order in which these 
macro instructions are introduced in the input stream. These numbers are used 
instead of names for identification purposes. For example, if the name is 
omitted from the sixth IOCONTRL macro instruction in the input stream, the 
name UNIT#6 is supplied in each diagnostic message resulting from an error 
encountered in the macro instruction. 



UNIT 
1051 



2403 



2404 



2415 



MODEL 
1 or N1 

1, 2, or 3 

4, 5, or 6 

1, 2, or 3 

1, 2, or 3 



FEATURE 



ALTCTRL* 
DATACONV 
7-TRACK 
16-DRIVE 

ALTCTRH 

DATACONV 

7-TRACK 

16-DRIVE 

800BPI 

ALTCTRLi 
DATACONV 
7-TRACK 

ALTCTRL* 
DATACONV 
7-TRACK 



Figure 81 (Part 1 of 3) 



ALTCTRL* 
DATACONV 
4, 5, or 6 7-TRACK 

800BPI2 

Keyword Values for IOCONTRL Macro Instruction 
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UNIT 
2701 
2702 
2703 



MODEL 



FEATURE 



2803 



2804 



2820 

2821 
2822 
2840 



1, 4, or 5 

2, or 3 



ALTCTRL* 
DATACONV 
7-TRACK 
16-DRIVE 

ALTCTRL* 

DATACONV 

7-TRACK 

16-DRIVE 

800BPI 

DATACONV 

7-TRACK 

16-DRIVE 

ALTCTRL* 
DATACONV 
7-TRACK 

ALTCTRLi 
DATACONV 
7-TRACK 
800BPI 

ALTCTRLi 
DATACONV 
7-TRACK 

SHARED 
2-CHANSW 

COLBNRY 



BUFFER8K 
ABSLTVEC 



lOCOIMTRL 



2841 



ADSTORAG or 2-CHANSW 
RECOFLO 
SHARED 



Figure 81 (Part 2 of 3). Keyword Values for IOCONTRL Macro Instruction 
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UNIT MODEL FEATURE 

2848 1, 2, 3, 21, or 22 LINEADDR 

NODESCUR 

3410 1, 2, or 3 800BPI 

7 -TRACK 

380 3 1, or 2 ALTCTRL* 

7-TRACK 
800BPI 

3811 

3272 1, or 2 

1 ALTCTRL can be specified only for an M65MP system. 

2 Dual density capability is provided when 800BPI is specified, therefore, 

dual density should not be specified in the IODEVICE macro instruction. 

Figure 81 (Part 3 of 3) . Keyword Values for IOCONTRL Macro Instruction 



Example: The following example illustrates the use of the IOCONTRL macro 
instruction to describe an IBM 2821 control unit. Model 4, with the column 
binary feature. The address of the control unit is 05. 

IOCONTRL UNIT=282 1 , MODEL=4, ADDRESS=05, FEATURE-COLBNRY 
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IODEVICE 

The IODEVICE macro instruction describes the characteristics of an input/output 
device and its operating system requirements. This macro instruction is 
required. 

Basic Requirements 

• Each uniquely addressable input/output device in the system must be 
specified in an IODEVICE macro instruction. 

• In the input deck for system generation, each IOCONTRL macro instruction 
must be immediately followed by the IODEVICE macro instructions that define 
devices attached to that control unit. 

• Figure 82 shows the valid combinations of values for the UNIT, MODEL, 
FEATURE, and ADAPTER parameters. 

• Telecommunications devices: There must be one IODEVICE macro instruction for 
each telecommunications line or 3705 Communications Controller. The IODEVICE 
macro instruction applies to a telecommunications line or a 3705 Communications 
Controller. 

• For telecommunication terminals: All terminals on a line must be of the 
same type with the same features. The type of terminal is used to identify 
the line in the UNIT parameter. 

• Unit address: The value specified in the ADDRESS parameter becomes the 
unit address of the device. Unit addresses are automatically assigned 
to the devices durinq system qeneration. 

• Device type: Durinq system qeneration, device types are also provided 
in every operating system for each type of device specified by the UNIT 
parameter of an IODEVICE macro instruction. Device types are described 
in Appendix A. 

• Group names: A device or a collection of devices can be assigned a group 
name by use of the UNITNAME macro instruction. 

• A maximum of 96 IODEVICE macro instructions can be specified during a 
system generation. If more devices are desired, a special procedure, which 
can be used under certain conditions, allows up to 768 devices to be 
specified. (See Appendix B for a description of the procedure.) The exact 
maximum number of devices allowed for a particular system depends on several 
factors, which are described in detail in Appendix B. 

• Burst devices cannot be specified for multiplexor channels or the multiplex 
portion of a high-speed multiplexor channel. Burst devices are: 2250, 
2301, 2302, 2303, 2305, 2311, 2314, 2321, 2401, 2402, 2403, 2404, 2415, 
2420, 3330, 3410, and 3420. 

Nucleus Generation 

The same IODEVICE macro instructions used during the last complete generation 
must be respecified without any changes. 

I/O Device Generation 

• All I/O devices that are to be in the new system must be specified. 

• There can be additions, deletions, changes, or the same specifications 
as those in the last complete generation. 
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Name Operation Operand 

[name] IODEVICE DNIT=junit j 

IDUMMYl 
ADDRESS= (address | 

I (address, no. of units)' 
MODEL=model] 
' FEATURE= (f eatureC , feature ]. . . ) ] 
(FIFO 
IOREQOE* PRIORITY 

ORDERED 
;ERRTAB=nnn] 
;DEVTYPE=type] 

For UNIT=2301, 2302, 2303 ,2305,231 1,231 4, 2321 ,2401, 
2402,2403,2404,2420,3330,3420,3704, or 3705 only: 

[ OPTCHAN= (address[ , address ]. . . ) ] 

For UNIT=2250 (models 2 or 3), 2280, or 2282 
Only: 

[NUMSECT=number] 

For UNIT=2314/2319, 3330/3333 (model 1), 
2401, 2415, 2420, 3410, and 3420 only: 

AP= (YES 
JNO 

For Telecommunications Devices Only: 

ADAPTER=adapter 
[ SETADDR=value ] 
[OBRCNT=number ] 



Name Field; 



name 



is used in system generation error messages (see Appendix D) to identify 
any IODEVICE macro instruction that produces an error. 

Operand Field: 



UNIT= (For any device) 

specifies the device type of the device. 

unit 

is a value that can be 1030, 1050, 1050X, 1052, 1053, 1060, 1130, 

1275, 1285, 1287, 1288, 1403, 1419, 1442, 1443, 2020, 2250, 2260, 

2265, 2280, 2282, 2301, 2302, 2303, 2305, 2311, 2314, 2321, 2401, 

2402, 2403, 2404, 2415, 2420, 2495, 2501, 2520, 2540R, 2540P, 2671, 
2740, 2740C, 2740X, 2741C, 2741P, 2780, 2955, 3066, 3158, 3210, 3211, 

3213, 3215, 3277, 3284, 3286, 3330, 3410, 3420, 3505, 3525, 3704, 3705, 

5450, 7770, 115A, 83B3, BSC1 , BSC2 , BSC3, S360, TWX 1 or WTTA 1 . 

terminals that are equivalent to those explicitly supported may 
also function satisfactorily. The customer is responsible for 
establishing equivalency. IBM assumes no responsibility for the 
impact that any changes to the IBM-supplied products or programs 
may have on such terminals. 
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Notes: 

• Telecommunications Lines: UNIT specifies the device type that is connected 
to the telecommunications line, or the type of binary synchronous line 
configuration: nonswitched point-to-point (BSC1) , switched point-to-point 
(BSC2) , or nonswitched multipoint (BSC3) . 

Binary synchronous may also be specified by ONIT=2780, 1130, 2220, or S360. 

• Restriction: Burst devices cannot be specified for a multiplexor 
channel or multiplex portion of high-speed multiplexor channel. 

• 1275: This device is available only through World Trade branch 
offices. 

• 1285, 1287, or 1288: The error routines for these devices can be 
loaded and made resident at IPL time by specification of EESIDNT=ERP 
in the SUPRVSOR macro instruction. 

• 1050X: Refers to the 1050 with the time-out suppression feature. 
I • 1419 : CIRB routine must be in the system. 

• 2020 or S360: These refer to a remote S/360 Model 20 or a remote 
S/360 attached to the channel through a 270 1 or 2703 control unit. 
For the purposes of system generation, this remote S/360 Model 20 
or remote S/360 is considered to be a telecommunications line, and 
must be defined as such with an IODEVICE macro instruction. 

• 2250: This is the Model 195 Integrated CRT operator's console. Model 
195 must be specified in the CENPROCS macro instruction, CONOPTS=MCS 
in the SCHEDOLR macro instruction, and M0DEL=1, 

FEATURE=(ALKYB2250,CHARGNTR,BUFFER4K or BUFFER8K...) must be specified 
in the IODEVICE macro instruction. 

• 2250 or 2260 Restriction: When the 2250 or 2260 is specified as an 
operator console, then CONOPTS=MCS must be coded in the SCHEDULR macro 
instruction. The GRAPHICS macro instruction must be coded for a 2250 
model 3 and the 2260. 

• 2305 (Models 1 and 2) Fixed-Head Disk Storage: If you specify the 2305, 
specify RESIDNT=ACSMETH in the SUPRVSOR macro instruction. Also add 
IGG019C4, IGG019FN, IGG019FP, IGG019EK to the standard RAM list, IEAIGG00, 
IGG019C0, which is already on the standard list, is also required. 

• 230 5 Restrictions: The ADDRESS parameter must indicate only one unit 
(although eight unit control blocks) will be generated, for example, 
UNIT=2305,ADDRESS=130 not ADDRESS= (130 ,8) . 

The unit position of the value specified for ADDRESS= must be either 
or 8, for example, ADDRESS=130 or ADDRESS-138. 

After a 2305 has been specified, the next succeeding device address 
must be at least 8 higher, for example, UNIT=2305, ADDRESS=130, 
UNIT=2311,ADDRESS=138. 

It must be 8 higher because of the eight UCBs generated which have 
the addresses 130-137. 

The 2305 must always be addressed by the low-order address (the address 
assigned during system generation) . 
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2319 (2314) ; The 2319 drives are functionally equivalent to the 2314 
drives. The default value for the 2319 is 8 drives. If you use less 
than 8 drives, you must specify the number of drives {see ADDRESS* 
in this section). To use a 2319, specify UNIT=2314: If you have 
a 2319 and you want to specify UNIT=2319, include the ONITNAME macro 
with a name of 2319. Appendix E contains a description of the 2319. 

2495 Tape Cartridge Reader ; This device can be specified on the 
multiplexor channel for Models 30, 40, 50, 135, 145, 155, and 
158 or on a control unit position on the 2870 multiplexor channel 
interface for Models 65, 75, 165, and 168. 

2540R and 2540P: These are the same IBM 2540 card read punch. Each 
function is specified in a separate IODEVICE macro instruction. 

2596 (1442 N1) : The 2596 card read punch is functionally equivalent 
to the 1442 N1 card read punch. If a 2596 is being used, the following 
must be specified: UNIT=1442; ADDRESS= (2596 device address); and 
MODEL=N1. The FEATURE=CARDIMAGE parameter may not be specified. 
For a detailed description of the 2596, see Appendix E. 

2740C and 2740X: 2740C refers to a 2740 using correspondence code 
(the inhibit command is automatically provided) ; 2740X refers to a 
2740 using the PTTC code (the inhibit command is automatically 
provided) . One of these devices must be specified if 2740 devices 
are to be used for CRJE. 

2741C and 2741P; 274 1C refers to a 2741 using correspondence code; 
274 1P refers to a 2741 using PTTC code. 

3066 : This is the S/370 Model 165 or 168 Integrated CRT Operator's 
Console. UNIT and ADDRESS are the only operands that can be 
specified. MODEL=165 or 168 must be specified in the CENPROCS 
macro instruction, CONOPTS=MCS must be specified in the SCHEDULR 
macro instruction, and the GRAPHICS macro instruction must be coded 
if graphics support is to be included. 

3330 Disk Storage Drive: If you specify the 3330, specify RESIDNT=ACSMETH 
in the SUPRVSOR macro instruction. Also add IGG019C4, IGG019FN, IGG019FP, 
IGG019EK to the standard RAM list, IEAIGG00. IGG019C0, which is already on 
the standard list, is also required. 

3333 (3330) : The 3333 Disk Storage and Control is functionally equivalent 
to the 3330. To use a 3333 specify UNIT=3330. If you specify the 3330, 
specify RESIDNT=ACSMETH in the SUPRVSOR macro instruction. Also add 
IGG019C4, IGG019FN, IGG019FP, IGG019EK to the standard RAM list, IEAIGG00. 
IGG019C0, which is already on the standard list, is also required. 

3704 and 3705 Communications Controllers : The ADAPTER operand must 
be specified; the OPTCHAN parameter may be specified. 

5450: This is the Model 85 Integrated CRT Operator' s Console. UNIT 
and ADDRESS are the only operands that can be specified. MODEL=85 must 
be specified in .the CENPROCS macro instruction, CONOPTS=MCS must be speci- 
fied in the SCHEDULR macro instruction, and the GRAPHICS macro instruction 
must be coded. 

BSC1: This refers to a nonswitched point-to-point binary synchronous 
line. This is specified no matter which types of remote BSC stations, 
supported by BTAM for this type of line, are connected to the line. 

BSC2: This refers to a switched point-to-point binary synchronous 
line. This is specified no matter which types of remote BSC stations, 
supported by BTAM for this type of line, communicate with the central 
computer over the line. (The central computer refers to the system 
for which this IODEVICE macro instruction is being written.) 
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• BSC3 ; This refers to a nonswitched multipoint binary synchronous 
line. This is specified no matter which types of remote BSC stations, 
supported by BTAM for this type of line, are connected to the line. 

• 2955 : ONLNTEST is assumed when you specify UNIT=2955 and do not 
specify ONLNTEST in the SUPRVSOR macro. An IODEVICE macro instruction 
must be specified for the 2955 if you have a 3158 processing Unit in 
order for data link software to function. 

• TWX: This refers to the teletype Model 33 or 35. 

DUMMY 

specifies an unsupported device. 

Notes : 

• UCB : A 32-byte UCB with all its standard fields is generated. 

• Support Routines : You must provide your own I/O support routines 
for the device. 

• Unit Address : Unit addresses are not generated for unsupported de- 
vices. If they are desired, they can be generated by the UNITNAME 
macro instruction. The unit address must be generated to make it 
possible to refer to the device with job control language statements. 

(See the examples following the description of the UNITNAME macro 
instruction. ) 

ADAPTER= (For telecommunications lines or 3705 Communications Controller) 

specifies the terminal control or transmission adapter used to connect a 
telecommunications line to a transmission control unit, or the type of 
channel adapter attaching a 3705 Communications Controller to a System/370 
channel. 



BSCA 



CA1 



CA2 



IBM1 



IBM2 



IBM3 



IBMT 



specifies that an IBM Binary Synchronous Terminal Adapter Type II 
attaches an 1130, 1800, 2020, 2715, 2770, 2780, 2972, 3275, 3277, 
3284, 3286, S/360, or S/360 Model 20 to a 2701, or IBM Binary 
Synchronous Terminal Control Type II attaches an 1130, 1800, 2020, 
2715, 2770, 2780, 2972, 3275, 3277, 3284, 3286, S/360, S/370, or 
S/360 Model 20 to a 2703. 

specifies that a Channel Adapter Type 1 attaches a 370 4 or 3705 
Communications Controller to a System/370 channel. 

specifies that a Channel Adapter Type 2 attaches a 3705 Communications 
Controller to a System/370 channel. 

specifies that an IBM Terminal Adapter Type I attaches a 1050, 1060, 
2740, 2740C, 2740X, 2741, 2741C, or 2741P to a 2701, or IBM Terminal 
Control Type I attaches a 1050, 1060, 2740, 2740C, 2740X, 2741, 2741C, 
or 2741P to a 2702 or 2703. 

specifies that an IBM Terminal Adapter Type II attaches a 1030 to a 
2701 or IBM Terminal Control Type II attaches a 1030 to a 2702 or 2703 

specifies that an IBM Terminal Adapter Type III attaches a 2848/2260 
to a 2701. 

specifies that an IBM Telegraph Adapter attaches a 1050 to a 2701 
or IBM Terminal Control Type I and a Telegraph Line Adapter attaches 
a 1050 to a 2702 or 2703. 
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TELE1 

specifies that a Telegraph Adapter Type I attaches a 1 1 5A or 83B3 
to a 2701, or Telegraph Terminal Control Type I attaches a 115A or 
83B3 to a 2702 or 2703. 

TELE 2 

specifies that a Telegraph Adapter Type II attaches a TWX to 2701, 

or Telegraph Terminal Control Type II attaches a TWX to a 2702 or 2703. 

TELEW 

specifies that a World Trade Telegraph Adapter (WTTA) attaches a World 
Trade telegraph terminal to a 2701, 2702, or 2703. 

ADDRESS=(For any device) 

specifies the address or addresses of devices or telecommunication lines. 

address 

is the unit address of three hexadecimal digits from 000 to DFF. 

Notes : 

• Required : If "no. of units" is specified, "address" must be the 
lowest address of the group of devices being specified. 

• UCB : For each device address that is assembled, a UCB is created. 

• Value : The high-order digit is the address of the channel (specified 
in the CHANNEL macro instruction) to which the device is attached. 
For example, if the unit address of the device is 190, the address 

of the channel is 1 . 

• Two-channel switch : For the IBM 2821 Control Unit with the two-channel 
switch feature, the low-order digit of the address must be as follows: 

printer (first) or 8 

card reader 1 or 9 

card punch 2 or A 

printer (second) 3 or B 

printer (third) 4 or C 

• 1275 and 1419 : The address specified must be the address of the 
primary control unit and must be an even number. The unit control 
blocks (UCB) for both the primary and secondary control units will 
be generated by the one IODEVICE macro instruction. 

There must be only one IODEVICE macro instruction for each 1275 or 1419 
Two addresses are generated by the one IODEVICE macro instruction. 

• 3270 : These devices are addressed in consecutive multiples of four. 
Do not skip addresses. 

no. of units 

is a value from 1 to 255 indicating the number of consecutively 
addressed devices of the same type attached to the same control unit. 

Default: If this subparameter is omitted, a value of 1 is assumed 
for all devices except the 2314 which has a default value of 8 and 
the 3330 which has a default value of 2. The maximum for a 2314 or 
3330 is 8. 
Notes : 

This subparameter is not valid for the 2305. 

Use: The value is the number of units to be used and the total number 
of sequential addresses to be assembled. For example, if 
ADDRESS=(190,5) is specified, the device addresses 190, 191, 192, 
193, and 194 would be assembled. 

DEVTYPE= (For any device) 

specifies any additional characteristics of the device, 
type 

is a value of hexadecimal characters. 
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Notes ; 

• This parameter should be specified if UNIT=DTJMMY is specified. 

• This parameter should conform to the standard format for the UCB device 
type fields . 

• Use : For further information about this keyword parameter, refer to OS 
MFT Guide or OS MVT Guide , and to the description of the UCB in OS System 
Control Blocks . 

ERRTAB= (For any device) 

specifies that an error routine, other than its standard error routine 
is to be used for the device. Either an IBM-supplied or a user-written 
routine may be specified. 



nnn 



is a decimal number from 000 to 254. 



Notes 



• IBM error routines : These have the values 000 through 219 and 230 through 

• User-written routines : These can have the values 220 through 229. 

• Error Routine Name : This decimal number (nnn) is used as the suffix of 
the name IGE00 under which the error routine is contained in SYS1.SVCLIB. 

• This parameter should be specified if UNIT=DUMMY is specified. 

FEATURE= (For any device) 

specifies the optional features that are present on the device. These 
values can be written in any order. Features enclosed in braces ( } are 
mutually exclusive, 
feature 

is one of the following values. 



Value 

ABSLTVEC 
ALKYB2250 
(ALKYB2260 
DEKYB2260 
NMKYB2260 
ALTCTRL 



ASCACHAR 
ASCBCHAR 
DOCHAR 
FRCHAR 
GRCHAR 
UKCHAR 
ASKY3277 
DEKY3277 
EBKY3277 
OCKY3277 
AUDALRM 
ADTOANSR 

AUTOCALL 

ADTOPOLL 



IBUFFER4K1 
lB0FFER8K| 
CARDIMAGE 
CHARGNTR 



Feature 

Absolute vector control on 2250 Model 1 

Alphameric keyboard on 2250 

Alphameric keyboard on 2260 

Alphameric-numeric insert keyboard 

Numeric keyboard on 2260 

Drives on a 2314 can be accessed through an alternate 

control unit. This can only be specified for an M65HP 

system. 

ASCII A character generator on 3277 

ASCII B character generator on 3277 

Domestic character generator on 3277, 3284, or 3286 

French character generator on 3277, 3284, or 3286 

German character generator on 3277, 3284, or 3286 

United Kingdom character generator on 3277, 3284, or 3286 

ASCII typewriter keyboard on 3277 

Data entry keyboard on 3277, used for KB66KEY only 

EBCDIC typewriter keyboard on 3277 

Operator console keyboard on 3277, used for KB78KEY only 

Audible alarm on 3277 

Automatic answering capability for 1050, 1130, 2020, 2740, 

2780, S360, or TWX. This is assumed if BSC2 is specified. 

Automatic calling feature for 1050, 1130, 2020, 2740, 

2780, S360, or TWX. This is assumed if BSC2 is specified. 

Automatic polling feature for 1030, 1050, 1060, 1130, 

2020, 2740, or 2780. If AUTOPOLL is specified for 2740, 

SCONTROL must also be specified. This is assumed if BSC3 

is specified. 

4096-byte buffer storage on 2250 Model 1 

8192-byte buffer storage on 2250 Model 1 

Card image on 1442, 2501, 2520, 3505, or 3525 

Character generator on 2250 Model 1 
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Value 



Feature 



CHECKING 

DESIGNFEAT 

DUALCODE 

DUALCOMM 

DUALDENS 

INTERRUPT 



KB66KEY 

KB70KEY 

KB 7 8 KEY 

KB81KEY 

LIGHTPEN 

MAGCDRD 

MDECOMPAT 

MULTILINE 

NUKLOCK 

OIU 

JOPPAN1] 
l0PPAN2l 
OPT1600 
PRGMKYBD 
READHRITE 
SCONTROL 

XCONTROL 

SELCHSET 

SELPEN 

SHARABLE 



SHARED 



TWOLINE 
UNVCHSET 

2-CHANSW 
7-TRACK 
9-TRACK 

24ADDPOS 



VRC/LRC checking on 2740 

Graphic design feature on 2250 Model 1 

Decode and dual code feature for 1130, 2020, 2780, BSC1, 

BSC2, BSC3, or S360 

Dual communication interface for 1130, 2020, 2780, BSC1, 

BSC2, BSC3, or S360 

Dual density on Model 4, 5, or 6 of 240 1, 2402, or 2403 on 

Model 2 or 3 of 3410 or on Model 3, 5, or 7 of 3420. 

Indicates the 2740 is a Model 1 with RPQ#S30031 added to 

allow improved performance when the 2740 is being used as 

an MCS console. 

6 6 -key keyboard on 3277 

70 -key keyboard on 3277 

7 8 -key keyboard on 3277 

81 -key keyboard on 3277 

Light pen detect on 2250 Model 1 or 2 

Magnetic card reader adapter on 3277 

Mode compatibility on Model 1, 2, or 3 of 2401, 2402r or 

2403 

3525 prints up to 25 lines per card. 

Numeric lock feature on 3277 

2760 Optical Image Unit; must be used with a 2740 that has 

checking specified. 

First operator control panel on 2250 Model 1 

First and second operator control panel on 2250 Model 1 

Dual density 6250/1600 BPI on 3420 Models 4, 6, or 8. 

Programmed function keyboard on 2250 
Simultaneous reading and writing on 2401, or 2402 
Station control feature on 2740. SCONTROL may not be 
specified if AUTOANSR or AUTOCALL is specified. 
Transmit control feature on 2740. XCONTROL reguires 
AUTOANSR, AUTOCALL or both. 
Selective character set on 1443 
Selector pen on 3277 

A 3420 is shared between two or more CPUs when the 3803 
two-channel switch is used for partitioning. When this 
feature is specified, it is the user's responsibility 
to partition tape drives between CPUs using the vary 
offline/online command.. 

The 2305, 2314, and 3330 can be shared by two or more 
CPUs. For the 2314, SHARED reguires the presence of 
either 2-CHANSW or a 2844 control unit, or both. (The 
presence of a 2844 is implied by FEATURE=SHARED and must 
not be specified elsewhere.) The 2305 and 3330 reguire a 
2-CHANSW but not a 2844 control unit. 
3525 prints one or two lines per card. 

Universal character set on 1403 Model 2, 3, or N1 (see the 
UCS macro instruction) 

2-channel switch on 2305, 2314, and 3330 

7-track head on 2401, 2402, 2403, 2404, 2415, 3410, or 3420 
9-track head on 2401, 2402, 2403, 2404, 2415, 3410, or 3420 
24 additional print positions on 1443 



Notes; 



2260: The FEATURE keyword is ignored if specified for a 2260 attached 
to a 2701 control unit by a 2848. 

2400: Either 7-TRACK or 9-TRACK must be specified when the value of the 
UNIT keyword is 2401, 2402, 2403, 2404, or 2415. 
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3400: Either 7-TRACK or 9-TRACK must be specified when the value of the 
UNIT keyword is 3410 or 3420. 

2740 with INTERRUPT Feature ; Must have a 2702 or 2703 with the feature 
#8200 or a 2701 with RPQ#858492. 
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• 2740C or 2740X: CHECKING must be specified for these devices. 

• 3277, 3284, or 3286: If a character generator is not specified, DOCHAR 
is assumed. 

• 3277 : No more than one keyboard may be specified. No keyboard need be 
specified if this device is being used as an output only device. 

• AUTOPOLL: When this is specified for the telecommunications line, neither 
AUTOCALL nor AUTOANSR can be specified for that line. AUTOPOLL is valid 
only if the control unit is either a 2702, 2703, or a 2701 with an IBH 
Binary Synchronous Terminal Adapter Type II (BSCA) . 

• DUALDENS: When this is specified, the device type names 2400 and 2400- 
3 are generated in addition to 2400-4. If DUALDENS is specified for a 
34 10 Model 2 or 3 or a 3420 tape unit, the following device type names 
are generated: 3400-4, 3400-3, 2400-4, 2400-3, and 2400. 

• DUALCODE and DUALCOMM: These can be specified only if the 
telecommunications line is attached to a 2701. 

• MDECOMPAT t Must be specified for models 1, 2, or 3 when 
the UNIT keyword is 2401, 2402, or 2403 when the control 
unit is 2403 model 4 or 6 or model 2 of 2803 or 2804. 

• OIU and SCON TROL or XCONTROL ; These are mutually exclusive. 

• OPT1600 ; When this is specified, the device type name 3400-6 
is generated . 

• READWRITE ; When this is used, one OPTCHAN must be specified. 

• SHARABLE : This feature must be specified for a 3420 tape drive that 
is shared between two or more CPUs using the 3803 switching capability 
and the VARY OFFLINE/ONLINE commands for assigning the device to one 
CPU only. This feature cannot be specified for an M65MP. 

I0REQUE= 

specifies the type of I/O request queuing to be provided by the supervisor 
for the device. 

FIFO 

specifies first-in-first-out queuing. 

PRIORITY 

specifies queuing according to task priority. 

ORDERED 

specifies queuing according to a cylinder address. 

Note: 

Ordered may be specified only for the 2311, 2314, 2321, or 3330. 

If this subparameter is specified for any other device, FIFO is substituted, 

MODEL= (Foe any device) 

specifies the model number, if any, of the device. 

model 

is a value that can be 1, 2, 3, 4, 5, 6, 7, 8, Bl, B2, B3, HI, or 
N2. 




Note: 



Required: This keyword parameter must be specified if the unit has a model 
number (see Fiqure 82) . 
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NDHSECT= (For 2250, 2280, or 2282) 

specifies the number of 256-byte buffer sections in the 2840 control unit 
that are guaranteed to be available to the 2250 (Model 2 or 3), 2280, or 
2282. These buffer sections can only be used by the device being specified 
in this IODEVICE macro instruction. 

number 

is a value from 1 to a maximum value that is computed as follows: 

A - B + 1 

256 

A is the size of the 2840 buffer. 

B is the number of devices attached to the 2840. 
Defaults: 

• If this keyword parameter is omitted, the device uses the sections not 
guaranteed to other devices; however, there must always be at least one 
section available (guaranteed or not) for assignment to each device. 

• If the 2250 Model 3 is specified as an operator console and this keyword 
parameter is omitted, a value of 16 is assumed. 

Notes: 

• 2250: . If the 2250 Model 3 is specified as an operator console, the number 
specified must be greater than 15. 

• Limit: The total amount of buffer sections guaranteed to the devices 
attached to a 2840 must not exceed the number of sections in the buffer 
of that 2840. 

• Available: All sections not guaranteed to a device are available to all 
devices attached to the 2840. 

• Information: Note that the assignment of guaranteed sections limits the 
number of available consecutive sections. For further information, see 
OS GPS for IBM "2250 Display Unit . 

AP= 

specifies the I/O devices that have an alternate power supply. 

YES specifies that the I/O device has an uninterruptable power supply. 

NO specifies that the I/O device does not have an uninterruptable 
power supply. 

OBRCNT= (For 2715 only) 

specifies the number of area stations connected to the 2715 on the 
communications line defined by this IODEVICE macro instruction. 

number 

is a number from to 800. 

Notes: 

The cumulative total of all values specified in OBRCNT keyword parameters 
cannot exceed 800 during a system generation. If 800 is exceeded, 800 will 
be assumed. 

OPTCHAN= (For 2301, 2302, 2303, 2305, 2311, 2314, 2321, 2401, 2402, 2403, 2404, 
2420, 3330, 3420, 3704, or 37Q5) 

specifies the alternate channels by which any of the above devices may 

be addressed. 

address 

is a value that must be greater than the high-order digit of the value 
in the ADDRESS keyword parameter, except for a selector subchannel. 
A selector subchannel must be specified as two characters. The first 
must be the channel address of the 2870, and the second must be D, E, or F. 
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Notes: 

• 

2301, 2302 f 2303 f 2305, 2311 f or 2321 ; Only one alternate channel may be 

specified. If this keyword parameter is specified for the 2302, 2303, 2311, or 

2321 devices, then 2-CHANSW is required on the 2841 control unit. The 2305 also 

requires a 2-CHANSW, but not with a 2841 control unit. 

• 2314: This requires the two-channel switch feature, a 2844 switching unit, 
or both. In these cases, the presence of the 2844 is implied by 
specification of the OPTCHAN parameter and must not be specified elsewhere. 
The two-channel switch for the 2314 is specified with the FEATURE keyword. 

• 2314, 2401, 2402, 2403, 2404, 2420, 3330 or 3420 : A maximum of three 
alternate channels can be specified. The addresses of alternate 
channels can be written; however, only one alternate channel may be 
specified in an M65MP system for any device. 

• 3704 and 3705 : This keyword parameter specifies the second channel to which 
the channel adapter is attached. Only one alternate channel can be specified. 

• Magnetic tape: If a magnetic tape drive has the READWRITE feature, only 
one alternate channel must be specified. A magnetic tape drive attached 
to a 2403 or 2803 control unit requires a 2816 in order to have alternate 
channel addressing. 

• Maximum: There is a maximum of 128 optional channel paths. 

• Required: There must be no more than one IODEVICE macro instruction for 
each I/O device, regardless of the number of alternate addresses given 
to the device. For example, if the primary address of a device is 181, 
and if it can also be addressed through channels 2, 3, and 4, there must 
not be separate IODEVICE macro instructions that define the address of 
the device as 281, 381, or 481. 

The primary address of the device, that is, the one with the lowest channel 
address, must be specified in the ADDRESS keyword. The other channel 
addresses must be specified with the OPTCHAN keyword. In this example, 
the macro instruction for the device must contain the parameters ADDRESS- 181 
and OPTCHAN=(2,3,4) . 

• Required for Alternate Channel: Each value specified is the address of 
an alternate channel as specified in the CHANNEL macro instruction. 

• SHARED : OPTCHAN can be specified for a 2314 or 3330 when SHARED has also 

been specified, but cannot be specified for a 2305. If SHARED and OPTCHAN 

are specified for a 3330, the machine feature, a 4-channel switch, must be 
present on the 3330 for it to function properly. 

• M65MP Restriction : If TYPE=M65MP is specified in the SCHEDULR macro, then 
only one alternate channel may be specified. 

SETADDR= (For telecommunication lines) 

specifies the set address (SAD) command to be issued for a 
telecommunications line attached to a 2702 or 2703 control unit. 

value 

is one of the following: 

Value Command 

SAD ZERO 

1 SADONE 

2 SADTWO 

3 SADTHREE 

Note: 

2702 : This keyword parameter must be specified if the device is attached 
to a 2702 control unit. 

System Generation Macro .Instructions 347 



IODEVICE 



Coding Hints and Additional Information 

If no name is entered, the macro instruction supplies sequential identification 
numbers to the IODEVICE macro instructions in the same order in which these 
macro instructions are introduced into the input stream. These numbers are 
used instead of names for identification purposes. For example, if the name 
is omitted from the eleventh IODEVICE macro instruction in the input stream, 
the name DEV#11 is supplied in each diagnostic message that results from an 
error encountered in the macro instruction. 



UNIT 
1030 

10501 

1050X 

10522 

1053 

1060 

11301 



MODEL 


FEATURE 


ADAPTER 




AUTOPOLL 


IBM2 




AUTOANSR 






AUTOCALL 


IBM1 or IBMT 




AUTOPOLL 






AUTOANSR 


IBM1 




AUTOCALL 




5, 6, 7 , or 8 






4 








AUTOPOLL 


IBM1 




AUTOANSR 






AUTOCALL 






AUTOPOLL 


BSCA 




DUALCODE 






DUALCOMM 





1275 
1285 
1287 
1288 



14033 

1419 
1442 
1443 



2, 


3 f or M1 


7 




N1 


or N2 


N1 





UNVCHSET 



CARDIMAGE 

SELCHSET 
24ADDP0S 



2020 



AUTOANSR 
AUTOCALL 
AUTOPOLL 
DUALCODE 
DUALCOMM 



BSCA 



Figure 82 (Part 1 of 6) . Keyword Values for the IODEVICE Macro Instruction 
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UNIT 



MODEL 



FEATURE 



ADAPTER 



2250 



1* 



ABSLTVEC 

ALKYB2250 

BUFFER4K 

or BOFFER8K 

CHARGNTR 

DESIGNFEAT 

LIGHTPEN 

OPPAN1 

or OPPAN2 

PRGMKYBD 



ALKYB2250 

LIGHTPEN 

PRGMKYBD 



35,19 



ALKYB2250 
PRGMKYBD 



2260* 



1 or 2 



ALKYB2260 
or NMKYB2260 
or DEKYB2260 



IBM3* 



226515 


2280 


2282 


2301 


2302 


2303 


2305 


2311 


2314 


2321 


2401 



IBM3* 



3 or 4 



1 or 2 



1, 2, or 3 



2-CHANSW, 
SHARED 



ALTCTRL* 
2-CHANSW 
SHARED 



READWRITE 
7-TRACK 
or 9-TRACK 
MDECOMPAT 




4, 5, or 6 



READWRITE 
9-TRACK 
DUALDENS 
7-track 



READWRITE 
7-track 



Figure 82 (Part 2 of 6) . Keyword Values for the IODEVICE Macro Instruction 



System Generation Macro Instructions 349 



UNIT MODEL FEATURE ADAPTER 

READWRITE 
1, 2, or 3 7-TRACK 

or 9-TRACK 
MDECOMPAT 
2402 

READWRITE 
4, 5, or 6 9-TRACK 

DUALDENS 

1, 2, or 3 7-TRACK 

or 9-TRACK 
MDECOMPAT 
240 3 

4, 5, or 6 7-TRACK 

or 9-TRACK 
DUALDENS 

24049 1, 2, or 3 7-TRACK 

or 9-TRACK 

2415 1, 2, 3, 4, 5, 7-TRACK 

or 6 or 9-TRACK 

2420 

2495 

2501 B1 or B2 CARDIHAGE 

2520 B1, B2, or B3 CARDIMAGE 

2540R 1 

2540P 1 

2671 1 



27401/ io 



2740C 

2740X 

2741C 
2741P 



AUTOANSR 




AUTOCALL 




AUTO POLL 


IBM1 


CHECKING* » 




INTERRUPT!* 




SCONTROL** 




or XCONTROLU 




oiun 




AUTOANSR 


IBM1 


CHECKING** 




AUTOANSR 




AUTOCALL 


IBM1 


CHECKING* « 




AUTOANSR 20 


IBM1 


AUTOANSR 


IBH1 



Figure 82 (Part 3 of 6) . Keyword Values for the IODEVICE Hacro Instruction 
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UNIT 

27801 

2955 
306617,19 

3158 

321018 

3211 

3213 2 ' 

3215*8 

3277 



MODEL 



1 or 2 



FEATURE 

AUTOANSR 
AUTOCALL 
AUTO POLL 
DUALCODE 
DUALCOMM 



ASCACHAR 
or ASCBCHAR 
or DOCHAR 
or FRCHAR 
or GRCHAR 
or KACHAR 
or UKCHAR 
ASKY3277 
or DEKY3277 
or EBKY3277 
or OCKY3277 
AUDALRM 
KB66KEY 
or KB70KEY 
or KB78KEY 
or KB81KEY 
MAGCDRD 
NUMLOCK 
SELPEN 



ADAPTER 



BSCA 



Figure 82 (Part 4 of 6) . Keyword Values for the IODEVICE Macro Instruction 
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UNIT 
3284 



3286 

3330 
3410 

3420 



3505 
3525 

3704 

3705 

5450 19 

7770 

115A 

83B3 

BSC1 



BSC2 



13 



BSC3 



S360 



TWX 



WTTA 



14 



MODEL 
1 or 2 



1 or 2 



1, 2 , or 3 



3,4,5,6,7, or 8 



FEATURE 

DOCHAR 
or FRCHAR 
or GRCHAR 
or KACHAR 
or UKCHAR 

DOCHAR 
or FRCHAR 
or GRCHAR 
or KACHAR 
or UKCHAR 

2-CHANSW, 
SHARED 

9 -TRACK 
or 7 -TRACK 
DUALDENS 

7 -TRACK 
or 9 -TRACK 
DUALDENS 
SHARABLE 
OPT1600 

CARD IMAGE 

CARD IMAGE 
MULTILINE or 
TWOLINE 



ADAPTER 



CA1 

CA1 or CA2 







TELE1 






TELE1 


Any BSC station 
on a nonswitched 
point-to-point line. 


DUALCODE 
DUALCOMM 


BSCA 


Any BSC station 
on a switched 
point-to-point 
line. 


AUTOCALL 
AUTOANSR 
DUALCODE 
DUALCOMM 


BSCA 


Any BSC station 
on a nonswitched 
multipoint line . 


AUTOPOLL 
DUALCODE 
DUALCOMM 


BSCA 




AUTOANSR 
AUTOCALL 
DUALCODE 
DUALCOMM 


BSCA 




AUTOANSR 
AUTOCALL 


TELE 2 



TELEW 



Figure 82 (Part 5 of 6) . Keyword Values for the IODEVICE Macro Instruction 
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*AUTOPOLL cannot be specified if either AUTOANSR or AUTOCALL (or both) is 
specified. 
*A 2150 used to connect a 1052 is addressed as the 1052, and may not be 

specified. 
3A 1404 printer is supported only as a continuous-form printer, and must be 

specified as a 1403 Model 2. 
♦If the 2250 Model 1 is specified as a console device, it must have the 
alphameric keyboard, character generator, and the 4K or 8K buffer. 
CONOPTS=MCS must be specified in the SCHEDULR macro instruction. 
*If the 2250 Model 3 is specified as a console device, it must have the 
alphameric keyboard. CONOPTS=MCS must be specified in the SCHEDULR macro 
instruction and the GRAPHICS macro instruction must be coded. 
6 If the 2260 Model 1 is specified as a console device, it must have the 
alphameric keyboard and the 2848 must be a Model 3 that has the line 
addressing feature. CONOPTS=MCS must be specified in the SCHEDULR macro 
instruction. 
*For only the 2848/2260 or 2845/2265. 
8 ALTCTRL can be specified only for an M65MP system. 

9 The READWRITE feature is implicit for the 2404 and must not be specified. 
*oif CONOPTS=MCS is specified in the SCHEDULR macro instruction and the 2740 is 
specified as a console device, the 2740 station control feature cannot be 
used, the 2740 must have the record checking feature, the 2740 can be 
connected only to the 2701, 2702, or 2703, and the communications line must 
be nonswitchable. Only one 2740 per communications line can be specified as 
a console device. 
*»CHECKING must be specified if OIU is specified; SCONTROL and XCONTROL cannot 

be specified if OIU is specified. 
**CHECKING must be specified. 
* 3 AUT0CALL and AUTOANSR are assumed. 
l4 AUT0P0LL is assumed. 

152845/2265 display control and display station. 
**If RPQ#S30031 is present, FEATURE=INTERRUPT may be specified. This offers 

improved performance in applications where contention for the console is high, 
i*Only for S/370 Model 165 and 168. 
i«0nly for S/370 Models, 135, 145, 155, or 158. 
*9C0N0PTS=MCS must be specified in the SCHEDULR macro instruction, and the 

GRAPHICS macro instruction must be coded. 
20 AUTOANSR cannot be specified for a 2741C if the control units are 
connected together (hard-wired) without telecommunications lines. 
Console-printer with no keyboard may only be attached to a 3158. 

Figure 82 (Part 6 of 6) . Keyword Values for the IODEVICE Macro Instruction 

Examples; The following example illustrates the use of the IODEVICE macro 
instruction to describe an IBM 1404 Model 2 printer. The address of the device 

is 20E. 

PRINTER2 IODEVICE UNIT=1403, MODEL=2, ADDRESS=20E 



The following example illustrates the use of the IODEVICE macro instruction 
to describe an IBM 2401 Model 3, magnetic tape drive with a 9-track head. 
The address of the device is 181. This device can be addressed alternatively 
through channel 2. 

TAPE1 IODEVICE UNIT=240 1 , ADDRESS^ 18 1 ,OPTCHAN=2, MODEL=3,F 
EATURE=9-TRACK 
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LINKLIB 

You can use the LINKLIB macro instruction to add your own routines, in load 
module form, to the link library (SYS 1. LINKLIB) for the new system. This macro 
instruction is optional. 

Basic Requirements 

• The load modules that are going to be included in SYS 1. LINKLIB must be 
members of a partitioned data set. 

• The data set that contains the load modules must be cataloged in the 
generating system as SYSLname. 

Processor/Library Generation 

• Sufficient space must have been allocated in SYS 1. LINKLIB for your own 
routines. 



Name Operation Operand 

LINKLIB PDS=SYS1.name 

MEMBERS- (namet ,name ]. . . ) 



PDS= 

specifies the partitioned data set that contains the routines to be added. 

SYS1. name 

The name cannot exceed eight alphameric characters. The first 
character must be alphabetic. 

MEMBERS= 

specifies the member to be added. 

name 

cannot exceed eight alphameric characters. The first character must 
be alphabetic. 

Note: 




• Maximum: A maximum of 20 routines may be included in the link library 
during one system generation process. 

Coding Hints and Additional Information 

The following example illustrates the use of the LINKLIB macro instruction 
to add the routines PAYROLL, COMPILER, and MOLT to the link library. These 
routines are members of the SYS1.USER partitioned data set. 



LINKLIB PBS=SYS1. USER, MEMBERS^ (PAYROLL, COMPILER, MULT) 
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LOADER 

This macro instruction specifies that the loader processing program is to be 
included. This instruction is optional. 

Basic Requirements 

• This macro instruction can appear only once in the input deck. 

Processor/Library Generation 

• The loader program can be added to or deleted from the system. 

• If it was specified in an earlier generation, it does not have to be 
respecified to keep it in the new system. 



Name 



Operation Operand 

LOADER [LIN=in ddname] 

[LIB=lib ddname] 
[ PRINT=print ddname] 
[ SIZE=size] 
[ PARM= (option[ , option ], 



.) ] 



LIN= 

in ddname 

is the ddname of the primary input data set that contains the input 
to the loader program. 

Default: If this keyword parameter is omitted, the default is SYSLIN. 

LIB= 

lib ddname 

is the ddname of the library that is searched to resolve external 
references. 

Default: If this keyword parameter is omitted, the default is SYSLIB. 

PARM= 

specifies the options that are used by the loader program. The options 
can be listed in any order. 

PRINT 

specifies that the diagnostic messages and the map of external 
references are written to the data set specified by the PRINT 
parameter. 

NOPRINT 

specifies that neither diagnostic messages nor the map of external 
references are written. 

Default: If NOPRINT is omitted, PRINT is the default value. 
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Notes: 

Required; PRINT must be specified if you want the map of external 
references. 

NOMAP 

specifies that the map of external references is not written. 

NAP 

specifies that the map of external references is written to the data 
set specified by the PRINT parameter. 

Default: If MAP is omitted, NOMAP is the default value. 

Notes: 



• Restriction: MAP cannot be specified if NOPRINT has been coded. 

• Required: PRINT must be specified if MAP is specified. 

NOLET 

specifies that execution of the loaded program is not attempted when 
a level 2 severity error occurs during loading. 

LET 

specifies that execution of the loaded program is attempted when a 
level 2 severity error occurred during loading. 

Default: If LET is omitted, NOLET is the default value. 

CALL 

specifies that the partitioned data set specified in the LIB parameter 
is searched for any unresolved external references that remain after 
the loaded program has been processed. 

NOCALL 

specifies that the partitioned data set specified in the LIB parameter 
is not searched. 

Default: If NOCALL is omitted, CALL is the default value. 

Note: 

Required: If NOCALL is specified, NORES must be specified. 

RES 

specifies that the resident modules are searched to resolve any 
external references that remain after the loaded program has been 
processed and before the SYSLIB defined data set is searched. 

NORES 

specifies that the resident modules are not searched. 

Default: If NORES is omitted, RES is the default value. 

Notes: 

• Required: CALL must be specified if RES is specified. 

• NORES cannot be specified if CALL has been specified. 

Default: If this keyword parameter is omitted, the default values are: PRINT, 
NOMAP, NOLET, CALL, RES. 
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PRINT= 

print ddname 

is the ddname of the data set used for the map of external references 
and the diagnostic messages. 

Default: If this keyword parameter is omitted, the default is SYSLODT. 

SIZE= 

is the amount of dynamic main storage reguired by the loader program to 
hold its own buffers, its own tables, and the problem program. 



size 



is a decimal number of the form nnnnK, that can be from 2K to 8192K. 
(K represents 1024 bytes.) 



Default: If this keyword parameter is omitted, the default is 100K. 



Coding Hints and Additional Information 



Detailed information about the loader program can be found in OS Linkage Editor 
and Loader. 

Information that can be used to plan for the loader program is provided below. 

Dynamic: The loader program will be loaded into the dynamic portion of main 
storage 

Resident: You can make the loader program resident in the reenterable load 
module area for MFT or in the link pack area for MVT (including M65MP) systems 
by: 

1. Adding either one or both loader program load module names to the RAM list 
in the SYS1. PARMLIB. 



2. Putting either one or both loader program load module names in a separate 
list and specifying their inclusion at NIP time. To make it possible to 
do this, the COMM option in the OPTIONS parameter of the SUPRVSOR macro 
instruction must be specified. When the message IEA101A reguests * SPECIFY 
SYSTEM PARAMETERS', the operator uses the RAM=aa form in the reply. 

Example: The following example illustrates the use of the LOADER macro 
instruction to specify the inclusion of the loader program in the new operating 
system. The data set SYSLODT is used to hold diagnostic messages and the map 
of external references. The dynamic storage available to the loader program 
is 50K. The map of external references is to be placed on SYSLODT. Execution 
is not attempted if there is a severity-level- 2 error during loading. SYSLIB 
will be searched for any unresolved references after the loaded program has 
been processed. The resident modules will not be searched to resolve any 
external references. 




LOADER 



PRINT=SYSLOOT,SIZE=50K,PARM=(MAP,NORES) 
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MACLIB 



The MACLIB macro instruction specifies the inclusion of the macro library 

(SYS 1. MACLIB) in the new operating system. This macro |instruction is optional. 

Basic Requirements 

• Space must be allocated for SYS 1. MACLIB. It may be cataloged in the new 
system during the preparation for system generation. 

• This macro instruction may not be used if the volume that contains 
SYS1. MACLIB of the generating system and the volume that is to contain 
the new SYS1. MACLIB cannot be mounted at the same time as the IEBCOPY step 
executed after the Stage II assemblies. (See "The Job Stream" section.) 
SYS 1. MACLIB may be included in the new system after system generation with 
the IEBCOPY utility program. 

• If this macro instruction is omitted, the IMDSADMP program are not included 
However, the IMDSADMP service aid program may also be retrieved from 

SYS 1. MACLIB after system generation, as described in OS Service Aids. 

Processor/Library Generation 

• This macro instruction can be used if SYS 1. MACLIB has not been added to 
the system either during a previous generation or with the IEBCOPY utility 
program. 



Name 



Operation 
MACLIB 



Operand 

UNIT=name 1 
VOLNO=serialJ 
; EXCLUDE= (option[ , option]. 



.) ] 



EXCLUDE 

specifies the groups of macro instructions to be excluded from the new 
SYS1. MACLIB has one or more of the following values. 



BTAM 



QTAM 



specifies that the macro instructions used for BTAM are to be excluded. 

I 
specifies that the macro instructions used for QTAM are to be excluded. 




TCAM 



specifies that the macro instructions used for TCAM are to be excluded. 



TSO 



GPS 



OCR 



FDM 



specifies that the macro instructions used for TSO are to be excluded. 

specifies that the macro instructions used for graphics programming services 
(GPS) are to be excluded. 

specifies that the macro instructions used for optical readers are to be 
excluded. 

specifies that the 3735 form description macros are to be excluded. 
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Note: 

Coding: These values can be listed in any order. 

UNIT= 

specifies a direct-access device in the generating system that will contain 
the volume on which the macro library will be generated. 

name 

is the device type. 

Default: If the UNIT and V0LN0 keyword parameters are omitted, the macro 
library is placed on the new system-residence volume. 

Note: 



Required: If this keyword parameter is specified, fOLNO must be coded. 

VOLNO= 

specifies the volume that is to contain the macro library. 

serial 

is the serial number. 

Default: If the UNIT and VOLNO keyword parameters are omitted, the macro 
library is placed on the new system-residence volume. 

Notes: 



• Value: The value specified must be the same as the value given to the 
VOLUME keyword parameter of the DD statement used to allocate space for 
SYS 1. MACLIB during the preparation for system generation. 

• Required: If this keyword parameter is specified, UNIT must be coded. 

Coding Hints and Additional Information 

This example illustrates the use of the MACLIB macro instruction to specify 
the inclusion of the macro library in the new operating system. The unit name 
is 2311. The volume serial number is 003475. The macro instructions used 
for graphic programming services are to be excluded from the new SYS1. MACLIB. 

MACLIB UNIT=231 1,VOLNO=003475,EXCLUDE=GPS 
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OUTPUT 

The OUTPUT macro instruction specifies the inclusion of the class defaults 
for the OUTPUT command in the new operating system. This macro instruction 
is optional and valid only in a complete operating system or processor 
generation of a TSO system. 

Basic Reguirement 

The CMDLIB macro instruction must be specified if the OUTPUT macro instruction 
is specified. 

Processor/Library Generation 

The CMDLIB macro instruction must be specified during a processor/library 
generation if it was not specified during the complete operating system 
generation. 

Name Operation Operand 

OUTPUT CLASS= ([ classname 1 ][ , classname2 ]) 

CLASS= 

specifies class defaults for the TSO OUTPUT command. 

classnamel 

is the background message class default. 

classname2 

is the print output class default. 

Default: The default value for either class is X. 

Note: 

Value: Each value specified must be a letter from A to Z or a number from 
to 9. 

Coding Hints and Additional Information 

This example illustrates the use of the OUTPUT macro instruction to specify 
the class defaults for the TSO OUTPUT command. X is the background message 
class default and A is the print output class default. 

OUTPUT CLASS=(,A) 




System Generation Macro Instructions 363 



PARMLIB 

The PARMLIB macro instruction specifies the inclusion of the parameter library 
(SYS1. PARMLIB) in the new operating system. This macro instruction is optional. 

Basic Requirements 

• Space must be allocated for SYS 1. PARMLIB. 

• If SYS 1. PARMLIB is not to reside on the system volume, it must be cataloged 
in the new system during the preparation for system generation. 

• If this macro instruction is not specified, a null data set must be defined 
for SYS1. PARMLIB in the new system. (See "Input Deck for Initialization" 
in the "Preparation for System Generation" section.) 

Processor/Library Generation 

• If a null SYS 1. PARMLIB is being replaced, it must be scratched and 
uncataloged before the new SYS 1. PARMLIB is initialized during the 
preparation for generation. 



Name Operation Operand 



PARMLIB ("UNIT=name 

l_VOLNO=seria: 



Default; If the UNIT and VOLNO keyword parameters are omitted, the parameter 
library is placed on the new system-residence volume. 

JNIT= 

specifies a direct-access device in the generating system that will contain 
the volume on which the parameter library will be generated. 

name 

is the device type. 

Note: 

Required; If this keyword parameter is specified, VOLNO must also be coded. 

VOLNO= 

specifies the volume that is to contain the parameter library. 

serial 

is a serial number. 

Notes; 

• Value; The value specified must be the same as the value specified in 
the VOLUME keyword parameter of the DD statement used to allocate space 
for SYS1. PARMLIB. 

• Required; If this keyword parameter is specified, UNIT must also be coded. 
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Coding Hints and Additional Information 



This example illustrates the use of the PARMLIB macro instruction to specify 
the inclusion of the parameter library in the operating system to be generated. 
The unit name is 2311. The volume serial number is RFS111. 



PARMLIB UNIT=231 1,V0LN0=RFS1 11 
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PARTITNS 

The PARTITNS macro instruction specifies the number of partitions and the class 
and size of each partition in an MFT system. This macro instruction is required 
and used only if TTPE=MFT is specified in the CTBLPROG macro instruction. 

Note: 

The Generalized Trace Facility (GTF) component of the control program requires 
a partition when started. If one problem partition or two problem partitions 
and TCAM are requested, an additional inactive (OK size) partition is generated. 

Nucleus Generation 

This macro instruction must be used to specify either the same or different 
partitions than those specified for the first MFT nucleus. 

Name Operation Operand 

PARTITNS operandf , operand ]. . . 



For Systems Without Hierarchies 

Each operand must be written in the following format for MFT without storage 
hierarchies: 

Pn(C-class,S-nK) 

Uppercase letters, parentheses, and hyphens must be written exactly as shown. 

Pn 

specifies the partition number. 

a 

is an integer from to 51. 

Note: 

• partitions must be numbered sequentially starting with 0, but they may 
be specified in any order. 

C-class 

specifies the function of the partition. 

class 

is one of the following values: 

OR 

specifies a resident reader partition. 

Note: A maximum of 3 resident reader partitions may be specified, 



PARTITNS 
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c-w 

specifies a resident writer partition. 

Note: A maximum of 36 resident writer partitions may be 
specified. 

C-xxx 

specifies a problem-program partition. 

XXX 

is one, two, or three alphabetic characters from A through 
that indicate the job classes that can use the partition. 



Notes: 



• The order in which these characters are written indicates the order in 
which the job classes are to be scheduled for the partition. 

• At least one, and not more than fifteen, problem-program partitions may 
be specified. 

S-nK 

specifies the size of the partition in bytes. 

nK 

must be an expression from 8K to xK, where xK is the size of main 
storage minus the size of the nucleus. (K represents 1024 bytes.) 

Notes: 

• All resident reader partitions and at least one problem-program partition 
must be at least the size of the scheduler. 

• The size of each resident writer partition must be at least 10K bytes. 

• If OPTIONS=PROTECT is specified in the SOPHVSOR macro instruction, n should 
be a multiple of 2 for all partitions. In this case, (n+1) is assumed 

at IPL time for each n that is not a multiple of 2. 

• HFT With Subt asking: When ATTACH with the subtasking capability is 
selected, the partition size must be large enough to hold all the tasks 
and all the subtasks that could exist at one time within a partition. 

For Systems With Hierarchies 

Each operand must be written in one of the following formats if HIARCHY=INCLUDE 
is specified in the CTRLPROG macro instruction: 

Pn(C-class,H0-nk) for partitions in hierarchy 

Pn (C-class,H1-hK) for partitions in hierarchy 1 

Pn (Oclass,H0-nK,H1-nK) for part ions consisting of two segments (one in 

each hierarchy) 

Uppercase letters, parentheses, hyphens, and numbers (0 and 1) must be written 
exactly as shown. 

If there is no IBM 2361 Core Storage unit on the system and hierarchy 1 is 
used, you will have to redefine the partitions at IPL time. 
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In using storage hierarchies on a Model 50, if reader or writer partitions 
are defined in hierarchy 1 and programs containing CCWs are loaded in hierarchy 
1, overran will occur. This will degrade the performance or result in an 
unrecoverable I/O error. 

Pn 

specifies the partition number. 

n 

is an integer from to 51. 

Note: Partitions may be specified in any order as long as every partition 
in the seguence is included. 

C-class 

specifies the function of the partition. 

class 

is one of the following values: 

OR 

specifies a resident reader partition. 

Note: A maximum of 3 resident reader partitions may be specified. 

C-W 

specifies a resident writer partition. 

Note: A maximum of 36 resident writer partitions may be 
specified. 

Oxxx 

specifies a problem-program partition. 

XXX 

is one, two, or three alphabetic characters from A through O 
that indicate the job classes that can use the partition. 

Notes: 

• The order in which these characters are written indicates the order in 
which the job classes are to be scheduled for the partition. 

• At least one, and not more than fifteen, problem-program partitions may 
be specified. 

HO-nK (for partitions in hierarchy 0) , H1*-nK (for partitions in hierarchy 1) , 
H0-nK,H1-nK (for segmented partitions) 

specifies the size of the partition in bytes. 

nK 

must be an expression from 8K to xK, where xK is the size of main 
storage minus the size of the nucleus. (K represents 1024 bytes.) 

Default: n should be a multiple of 2; if it is not, (n+1) is assumed at 
IPL time. 
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Notes: 

• All resident reader partitions and at least one problem-program partition 
must be at least the size of the scheduler. 

• The size of each resident writer partition must be at least 10K bytes. 

• Resident reader and resident writer partitions must not be segmented. 

Coding Hints and Additional Information 

This example illustrates the use of the PARTITNS macro instruction to generate 
a four-partition system. Partition is a 30720-byte problem program partition. 
Jobs that specify CLASS=B on their JOB cards are scheduled into partition 0. 
If no CLASS=B jobs are pending, CLASS-C jobs are scheduled. If neither CLASS=B 
nor CLASSIC jobs are pending, then CLASS-A jobs are scheduled into partition 
0. Partition 2 is a 10240-byte resident writer partition. Partition 1 is 
a 30720-byte resident reader partition (partition 1 need not be specified 
before partition 2> . Partition 3 is a 36864-byte problem-program partition. 
Only jobs that specify CLASS-D are scheduled into partition 3. 

PARTITNS P0(C-BCA,S-30K) , P2 (C-W,S-10K) ,P1 (C-R,S-30K) , 
P3(C-D,S-36K) 

The following example illustrates the use of the PARTITNS macro instruction 
to generate an eight-partition system with LCS. Partition is a 47104-byte 
problem-program partition in hierarchy that supports job classes A, D, and 
E. Partition 1 is a 47107-byte resident reader partition in hierarchy 0. 
Partition 4 is a 10240-byte resident writer partition in hierarchy 0. Partition 
3 is a segmented problem- program partition with 20480 bytes in hierarchy 
and 102400 bytes in hierarchy 1. Partition 3 supports job classes D, and F. 
Partition 5 is a 20480-byte resident reader partition in hierarchy 0. Partition 
6 is a 14336-byte resident writer partition in hierarchy 0. Partition 7 is 
a 204800-byte problem-program partition in hierarchy that supports job classes 
C and A. Partition 2 is a segmented problem-program partition with 10240 bytes 
in hierarchy and 51200 bytes in hierarchy 1. Partition 2 supports job class 
M. 

PARTITNS P0(C-ADE,H0-46K) ,P1 (C-R,H0-46K) , 

P4(C-W,H0-10K) ,P3(C-DF,H0-20K,H1-100K) , 
P5 (C-R, H0-20K) , P6 (C-W, HO- 1 4K) , 
P7(C-CA,H0-200K) ,P2 (C-H,H0- 10K,H1-50K) 
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PL1 



The PL1 macro instruction specifies the inclusion of the PL/I compiler, 
macro instruction is optional. 



This 



Basic Requirements 

• PL1LIB macro instruction must be specified. 

• INSTSET=UNIV must be specified in the CENPROCS macro instruction. 

• If an automatic restart of a job step is to be forced or canceled by using 
the IHERES routine, the user completion code 4092 must be specified in 
the ELIGBLE keyword parameter of the CKPTREST macro instruction. The RD 
parameter must also be specified in the JOB or EXEC statement with R or 
RNC as the subparameter. 

Processor/Library Generation 

• There must be sufficient space for the new PL/I compiler in SYS1 .LINKLIB. 

• The PL1LIB macro instruction must be specified. 

• The PL/I compiler being added must be of the same release level as the 
generating system. 

If the compilation time defaults are going to be changed, then these additional 
conditions must exist: 

• The member IEMAP must be scratched from SYS 1. LINKLIB. (To regain the space 
occupied by IEMAP, use the IEBCOPY utility program.) 

• The PL1LIB macro instruction must be the same as that used during the last 
generation, unless SYS1.PL1LIB is redefined. 



Name 



Operation 
PL1 



Operand 

DESIGN=F 
[ SIZE=size] 
CHARSET=|CHAR60 
ICHAR48 
PONCH=[ NODECK j] 
I DECK I J 
TYPERUN= [ LOAD 

INOLOAD 








SORCODE= 



OBJLIST* 



EBCDIC 
BCD 
HO LI ST 



MSGLEV= 



LIST 
FLAGW. 



FLAGE 
FLAGS 



SYNTXLV 55 



SYNCHKS 
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Name 



Operation 



Operand 



PL1 
(continued) 



J. 
0PT={2 


SORLIST 

EXTLIST 

'atrlist 

REFLIST 



SOURCE 



NOSOORCE 
NOEXTREF I 
EXTREF I 



= |NOATR|~| 



lATR 



SORMGIN 
LINECNT 

CMPTIME 

MACLIST 

MCPUNCH 

COMPILE 

STMDIAG 

DICTYPE 

OPRINT- 

LEVCNT= 

OBJCODE 

PAGECTL 
DELETE^ 



= jNOXREFJl 
IXREF ij 
= (m,n) ] 
^number ] 
NOMACRO 
MACRO 
SOURCE2 



I] 



NOSOURCE2 
-( NOMACDECK 
I MAC DECK 
COMP 
NOCOMP 
NOSTMT 



STMT 
NOEXTDIC 



I] 



EXTDIC 

OP 

NOOP 
[ HONEST 
INEST 
=jOBJOUT 

lOBJIN 
=column ] 
(item[ , item].. .) ] 



CHARSET= 

specifies the number of characters in the character set used to write the 
source program to be compiled. 

CHAR60 

specifies a character set with 60 characters. 

CHAR48 

specifies a character set with 48 characters. 

Default: If this keyboard parameter is omitted, CHAR60 is assumed. 

DESIGN^ 

specifies the F-design level of the PL/I compiler. 

SIZE= 

specifies the maximum number of bytes of main storage available to the 
PL/I compiler at compilation time. 

size 

is an integer from U5056 to 999999. 

Default: If this keyword parameter is omitted, a value of 999999 is assumed. 
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Notes: 

• Use: For further information on this keyword parameter, refer to OS PL/I 
1EL Pro grammer's Gui de. 

• Recommended; It is recommended that SIZE*999999 not be used if the storage 
available is 49152 bytes or less. In this case, the compiler may calculate 
that there is not enough storage available when, in fact, compilation is 
still possible. To avoid this situation, an actual value must be given 

to SIZE. 

• Maximum: If 999999 is specified, all available main storage is to be used 
by the PL/I compiler. 

The following keyword parameters provide the setting of defaults for the various 
options that can affect a PL/I compilation. Defaults are the options that 
are assumed if the corresponding values of the PARH keyword parameters are 
omitted from an EXEC statement in a PL/I compilation. The DELETE keyword 
parameter specifies a list of values that cannot be used as values of the PARH 
keyword parameter. 

ATRLIST= 

specifies the production of a listing for each identifier, giving the 
identifier with full gualification, the statement number declaring the 
identifier, and a list of attributes pertaining to the identifier. 

ATR 

specifies that a listing is to be produced. 

NOATR 

specifies that a listing is not to be produced. 

Default: If this keyword parameter is omitted, NOATR is assumed. 

CMPTIME= 

specifies whether there is to be processing during compilation. 

MACRO 

specifies that compilation-time processing is reguired. 

NOHACRO 

specifies that compilation-time processing is not reguired. 

Default: If this keyword parameter is omitted, NOHACRO is assumed. 

COMPILE= 

specifies that compilation is to proceed after the compilation-time 
processor has been used. 

COMP 

specifies that compilation is required. 

NOCOHP 

specifies that compilation is not required. 

Default: If this keyword parameter is omitted, COMP is assumed. 
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DICTYPE= 

specifies that an extended capacity dictionary is to be used even at the 
expense of compilation time. 

EXTDIC 

specifies that a extended dictionary is to be used. 

NOEXTDIC 

specifies that a normal dictionary is to be used. 

Default: If this keyword parameter is omitted, NOEXTDIC is assumed. 

EXTLIST= 

specifies the production of a listing of all external data, external 
entries, and files. 

EXTREF 

specifies that a listing is to be produced. 

NOEXTREF 

specifies that a listing is not to be produced. 

Default; If this keyword parameter is omitted, NOEXTREF is assumed. 

LEVCNT= 

specifies the production of a scope level and DO-nest depth count with 
the source listing. 

NEST 

specifies that a listing is to be produced. 

NONEST 

specifies that a listing is not to be produced. 

Default; If this keyword parameter is omitted, NONEST is assumed. 

LINECNT= 

specifies the maximum number of lines to be printed in each page of a PL/I 
compiler output listing. 

number 

is an integer from 10 to 99. 

Default: If this keyword parameter is omitted, a value of 50 is assumed. 

MACLIST= 

specifies the listing of the input to the compilation-time processor. 

SOURCE2 

specifies that a listing is to be produced. 

NOSOURCE2 

specifies that the listing is not to be produced. 

Default: If this keyword parameter is omitted, S00RCE2 is assumed. 
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MCPONCH= 

specifies the production of a punched deck of the compilation-time processor 
output. 

MACDECK 

specifies that a deck is to be produced. 

NOMACDECK 

specifies that a deck is not to be produced. 

Default: If this keyword parameter is omitted, NOMACDECK is assumed. 

MSGLEV= 

specifies the type of compilation messages to be printed. 

FLAGW 

specifies that warning messages, error messages, and severe error 
messages are to be printed. 

FLAGE 

specifies that only error messages and severe error messages are to 
be printed. 

FLAGS 

specifies that only severe error messages are to be printed. 

Default: If this keyword parameter is omitted, FLAGW is assumed. 

OBJCODE= 

specifies the inclusion of additional code and a module in the object 
program to handle imprecise interrupts and to provide complete support 
for running the object program on a S/360 Model 9 1 or 195. 

OB JIN 

specifies that the additional code and module are to be included. 

OBJOUT 

specifies that the additional code and module are not to be included. 

Default: If this keyword parameter is omitted, OBJOUT is assumed. 

OBJLIST= 

specifies the production of a listing of the object program. 

LIST 

specifies that a listing is to be produced. 

NOLIST 

specifies that a listing is not to be produced. 

Default: If this keyword parameter is omitted, NOLIST is assumed. 

OPRINT= 

specifies the production of a listing of compiler options. 

OP 

specifies that this listing is to be produced. 

NOOP 

specifies that it is not to be produced. 

Default: If this keyword parameter is omitted, OP is assumed. 
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OPT= 

specifies optimization of execution time of the object program produced 
by the compiler. 



specifies that the object program is to be optimized unless it 
increases the object-time storage reguirements. 

1 

specifies that the object program is to be optimized even at the 
expense of the object-time storage reguirements. 

2 

specifies the same function as 0PT=1 and that the object code for 
DO groups, subscripts, and array expressions will be optimized even 
though it may severely affect the compilation time. 

Default: If this keyword parameter is omitted, 1 is assumed. 

PAGECTL=column 

specifies the number of the column in which a control character is to be 
specified. 

Default: If this keyword parameter is omitted, no page control is provided. 

Note: 

The number must be outside the scope of the values in the SORMGIN keyword 
parameter. 

PUNCH- 

specifies the production of a punched deck of the object program. 

DECK 

specifies that a punched deck is to be produced. 

NODECK 

specifies that a punched deck is not to be produced. 

Default: If this keyword parameter is omitted, NODECK is assumed. 

REFLIST= 

specifies the production of a listing for each identifier, including the 
identifier with full gualification, the number of the statement that 
declares the identifier, and a list of all statements in which reference 
is made to the identifier. 

XREF 

specifies that a listing is to be produced. 

NOXREF 

specifies that a listing is not to be produced. 

Default: If this keyword parameter is omitted, NOXREF is assumed. 



376 OS Syste* Generation 



SORCODE= 

specifies the character set used to keypunch the source programs to be 
compiled. 

BCD 

specifies the BCD character set. 

EBCDIC 

specifies the EBCDIC character set. 

Default: If this keyword parameter is omitted, EBCDIC is assumed. 

SORLIST= 

specifies the production of a printed listing of the PL/I source program. 

SOURCE 

specifies that a listing of the source text is to be produced. 

NOSODRCE 

specifies that a listing is not to be produced. 

Default: If this keyword parameter is omitted, SOURCE is assumed. 

SORMGIH= 

specifies the margins for scanning of the source statements. 

m 

specifies the beginning margin 

n 

specifies the end margin. If the source statement input to the 

compiler is from the system input stream (that is, if it follows a 

DD* statement) , the condition 2 < m< n< 100 must hold. 

Default: If this keyword parameter is omitted, a value of 2 is assumed for 
m and a value of 72 is assumed for n. 

STMDIAG= 

specifies the contents of diagnostic messages printed during execution 
of the compiled source program. 

STMT 

specifies that the messages are to contain source program statement 
numbers. 

NOSTMT 

specifies that the messages are not to contain source program statement 
numbers. 

Default: If this keyword parameter is omitted, NOSTHT is assumed. 

Note: 

Offsets from PL/I entry points are included in the messages in both cases. 

SINTXLV= 

specifies the condition for compilation termination if errors occur during 
syntax checking. 

SINCHKE 

specifies that termination will occur after compilation if an error 
of severity ERROR or above is found. 
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SYNCHKS 

specifies that termination will occur after compilation if an error 
of severity SEVERE or above is found. 

SYNCHKT 

specifies that termination will occur immediately if an error of 
severity TERMINATION is found. No special message will be printed. 

Default; If this keyword parameter is omitted, SYNCHKT is assumed. 

TYPERUN= 

specifies the production of input to the linkage editor from the program 
being compiled. 

LOAD 

specifies that the program is to be processed by the linkage editor 
after compilation. 

NOLDAD 

specifies that the source program is to be compiled only. 

Default: If this keyword parameter is omitted, LOAD is assumed. 

DELETE= 

specifies that the keyword values or keywords in the value list cannot 
be used at compilation time in the PARM field of the EXEC statement. The 
following values can be specified; each has been described above: 

ATR LINECNT NOLOAD OPT 

BCD LIST NOMACDECK PAGECTL 

CHAR48 LOAD NOMACRO SIZE 

CHAR60 MACDECK NONEST SORMGIN 

COMP MACRO NOOP SOURCE 

DECK NEST NOSOURCE S00RCE2 

EBCDIC NOATR N0S00RCE2 STMT 

EXTDIC NODECK NOSTMT SYNCHKE 

EXTREF NOCOMP NOXREF SYNCHKS 

FLAGE NOEXTDIC OBJIN SYNCHKT 

FLAGS NOEXTREF OBJOUT XREF 

FLAGW NOLIST OP 

Coding Hints and Additional Information 

Syntax Checker: The syntax checking routines for this compiler can be included 
in the new or modified system by use of the CHECKER macro instruction. 

Example: The following example illustrates the use of the PL1 macro instruction 
to specify an F-design- level PL/I compiler that operates in 56320 bytes of 
main storage. The compiled source programs are to be processed by the linkage 
editor unless otherwise specified at compilation time. All warning and error 
messages are to be printed, the EBCDIC character set is used to punch the 
source programs, the character set used to write the source programs has 60 
characters, and the execution time of the object programs is not to be 
optimized. 

The default options for scanning the source statements are 2 and 72, and there 
are 50 lines per printed page. 
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The following keywords and keyword values cannot be used at compilation time 
in the PARM field of the EXEC statement: CHAR48, BCD, FLAGE, FLAGS, OPT, 
LINECNT, and SORMGIN. Unless otherwise specified at compilation time, listings 
of the source text are to be produced. The following, however, are not 
produced: 

A punched deck of the object program 

Listings of the object program 

A listing of external data, entries, and files 

Listings of identifiers and their attributes 

Numbers 

Qualifications 

References 

Unless specified at compilation time, compilation-time processing is not 
required, and the diagnostic messages are not to contain source program 
statement numbers. 

PL1 DESIGN=F,TYPERUN=LOAD,SIZE=56320, 

DELETE=(CHAR48, BCD, FLAGE, FLAGS, OPT, LINECNT, SORMGIN) 
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PL1LIB 

The PL1LIB macro instruction specifies the inclusion of the PL/I subroutine 
library (SYS1.PL1LIB) in the new operating system. This macro instruction 
is optional unless the PL1 macro instruction is specified — then it is 
required. 

Basic Requirements 

• Space must be allocated for SYS 1. PL1LIB. 

• SYS1.PL1LIB may be cataloged in the new system during the preparation for 
system generation. 

• The shared-library feature can be used only with an operating system that 
is of Release 18 level or later. 

Processor/Library Generation 

• The SOPRVSOR macro instruction used during the last complete system 
generation must be used with all the parameters coded exactly the same 
way. 

• The PL1 macro instruction does not have to be used. 

• The PL/I library being added must be of the same level as the generating 
system. 

If the PL1LIB macro instruction is used to respecify an existing 
SYS1.PL1LIB, then these additional guidelines must be used. 

• The existing SYS 1. PL 1 LIB should be scratched and uncataloged before the 
new SYS1.PL1LIB is initialized. (To regain the space occupied by the old 
SYS1.PL1LIB, use the IEBCOPY utility program.) 

• If SYS1.PL1LIB is respecified for a previously generated PL/I compiler, 
then the generating system must be of the same level as the system used 
to generate the existing PL/I compiler. 
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Name 



Operation 
PL1LIB 



Operand 

UNIT=name 
V0LNO=serial 
LIBPCNS= IREAL 



] 



COMPLEX 



]• 



MODES= / 1 NOTK I [ , operand ][ , operand ] \ 

If MODES is specified, then the following 
parameters can be used: 



[ STORG* 
[CONVS* 
[ STRGS* 
[ARRAYS 
[MATHS= 
[ STRIO= 
[RECIO= 



(operand[ , 
(operandf , 
(operand[ , 
(operandf , 
(operandf , 
(operandi r 
(operand[ , 



operand]. • 
operand]. . 
operand]. . 
operand]. • 
operand ]. . 
operand]. . 
operand]. . 



ONIT= 

specifies a direct-access device in the generating system that will contain 
the volume on which the PL/I subroutine library will be generated. 



name 



is the device type. 



Default: If the UNIT and VOLNO parameters are omitted, the PL/I subroutine 
library is placed on the new system-residence volume. 

Note: 

Required: If this keyword parameter is specified, VOLNO must be coded. 

VOLNO= 

specifies the volume that is to contain the PL/I subroutine 
library. 

serial 

is the serial number. 

Default: If the UNIT and VOLNO parameters are omitted, the PL/I subroutine 
library is placed on the new system-residence volume. 

Notes: 

• Value: The value specified must be the same as the value given to the 
VOLUME keyword parameter of the DD statement used to allocate space for 
SYS1.PL1LIB during the preparation for system generation. 

• Required: If this keyword parameter is specified, UNIT must be coded. 
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LIBFCNS= 

specifies the inclusion of complex object-time functions in SYS1.PL1LIB. 

REAL 

specifies that the complex functions are not to be included. 

COMPLEX 

specifies that the complex functions are to be included. 

Default: If this keyword parameter is omitted, REAL is assumed. 

MODES= 

specifies that the PL/I shared library feature is to be included in the 
new system. 

NOTK 

specifies that the form of the modules included will be for tasks 
that are not multitasking. 

TASK 

specifies that the form of the modules included will be for tasks 
that are multitasking. 

Default: If this keyword parameter or both NOTK and TASK are omitted, 
NOTK is assumed. 

Notes: 

• These two subparameters are mutually exclusive. 

• The subparameter that is selected to be coded must appear first in 
the parameter statement. 

• A shared library for a multitasking program cannot be used by a program 
that is not multitasking. The reverse is also true: a shared library 
for a program that is not multitasking cannot be used by a multitasking 
program. 

REAL 

specifies that only modules that deal with real expressions will be 
made resident. 

CMPX 

specifies that only modules that deal with complex expressions will 
be made resident. 

Default: If this keyword parameter or both REAL and CMPX are omitted, 
REAL is assumed. 

Notes: 

• It is recommended that when CMPX is specified that REAL also be 
specified, since many of the CMPX modules use real modules. 

• Either REAL or CMPX, or both, must be specified if the shared-library 
feature is desired. 

Default: If this keyword parameter is omitted, NOTK and REAL are assumed. 
Notes: 

COMM must be specified in the OPTIONS parameter and RENTCODE must be specified 
in the RESIDNT parameter of the SUPRVSOR macro instruction. 
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When the MODES keyword parameter is specified, the following seven keyword 
parameters can be used. 

ARRAY= 

specifies which array-handling modules are made resident. 

BASIC 

specifies the modules that perform all array functions on 
noninterleaved arrays. 

LEAF 

specifies the modules that perform all array functions on interleaved 
arrays. 

Note: 

Each group is modified to agree with the REAL or CHPX subparameter specified 
in the MODES parameter. 

C0N7S= 

specifies which conversion package modules are made resident. 

BASIC 

specifies the most commonly used conversion modules. 

EDIT 

specifies the conversion modules associated with the edit stream I/O 
conversions. 

BIT 

specifies the bit string conversion modules. 

CHAR 

specifies the character string conversion modules. 

PICT 

specifies the modules commonly used in converting variables with the 
PICTURE attribute. 

STERL 

specifies the modules used when performing sterling conversions. 

0PT1 

specifies the conversion modules selected when 0PT=1 or OPT- 2 has 

been specified in the PL1 macro instruction. If this option is selected, 

at least one of the options EDIT, PICT or STERL must also be specified. 

MATHS= 

specifies which modules associated with the arithmetic operators and built- 
in functions will be made resident. 

BASIC 

specifies the modules that are concerned with arithmetic operators, 
including the function forms of operators. 

SHORT 

specifies the modules associated with the short-precision form of 
the arithmetic built-in functions. 
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LONG 

specifies the modules associated with the long-precision form of the 
arithmetic built-in functions. 

Mote; 

Each group is modified to agree with the HEAL or CMPX subparameter in the HODES 
parameter. 

RECIO= 

specifies which modules that are common to all modes of record-oriented 
I/O are made resident. 

BASIC 

specifies the modules that are common to the initialization of any 
record- oriented I/O statement. 

WAIT 

specifies the modules that handle the record-oriented I/O wait option. 

Note; 

Each group is modified to agree with the NOTK or TASK subparameter specified 
in the MODES parameter. 

STORG= 

specifies that some storage- management modules are made resident. 

ERR 

specifies that the error-handling modules are made resident. This 
includes all ON codes. 

LISTP 

specifies that all list processing modules are made resident. 

Note; 

The basic storage-management modules are automatically included if the 
HODES»TASK parameter is specified. 

STRGS= 

specifies which string-handling modules are made resident. 

BIT 

specifies the bit-string-handling modules. 

CHAR 

specifies the character-string-handling modules. 

STR 

specifies only the STRING built-in function and pseudo variable 
modules. 

STRIO= 

specifies which stream-oriented I/O modules are made resident. 

DATA 

specifies the modules that handle data-directed stream I/O. 
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LIST 

specifies the modules that handle list-directed stream I/O. 

EDIT 

specifies the modules that handle edit-directed stream I/O. 

Note; 

Each group is modified to agree with the NOTK or TASK subparameter speciiied 
in the MODES parameter. 

Coding Hints and Additional Information 

Detailed information can be found in the following publications: 

OS PL/I (F) Subroutine Library 

OS GSP for FORTRAN IV, COBOL, and PL/I 

Shared-Library Feature: The following guidelines should be used when specifying 
the shared library. 

MODES — This keyword parameter must be specified if the shared-library feature 
is desired. NOTK and REAL are the default values. NOTK and TASK 
are mutually exclusive positional subpar a meters for MODES. The 
selected one must be coded first. 

STORG — This keyword parameter can be used only if MODES is specified. 

CONVS — This keyword parameter can be used only if MODES is specified. BASIC 
is dependent on whether REAL or CMPX is specified. 

STRGS — This keyword parameter can be used only if MODES is specified. 

STRIO — This keyword parameter can be used only if MODES is specified. The 
subpar ameters depend on whether NOTK or TASK is specified. 

RECIO — This keyw^d parameter can be used only if MODES is specified. The 
subparameters depend on whether NOTK or TASK is specified. 

ARRAY — This keyword parameter can be used only if MODES is specified. The 
subparameters depend on whether REAL or CMPX is specified. 

MATHS — This keyword parameter can be used only if MODES is specified. The 
subparameters depend on whether REAL or CMPX is specified. 



If MODES 55 (any combination of subparameters) 

Then any of the following keyword parameters and associated subparameters can 
be used: 



STORG 


with 


ERR 


LISTP 




CONVS 


with 


EDIT 


BIT 


CHAR 






PICT 


STERL 


0PT1 



STRGS with BIT CHAR STR 



Figure 83 (Part 1 of 3) . Summary of Coding Dependencies for the Shared-Library 

Feature 



386 OS System Generation 



In addition to the combination above or below: 

If MODES= NOTK or TASK 

Then any of the following keyword parameters and associated subparameters can 
be used. 



STRIO 
RECIO 



With 
with 



DATA 
BASIC 



EDIT 
WAIT 



LIST 



In addition to the combination above: 

If MODES= SEAL or CMPX 

Then any of the following keyword parameters and associated subparameters can 
be used: 



MATHS with BASIC SHORT 

CONVS with BASIC 

ARRAY with BASIC LEAF 



LONG 



Figure 83 (Part 2 of 2) . Summary of Coding Dependencies for the Shared-Library 

Feature 



Example: The following example illustrates the use of the PL1LIB macro 
instruction to specify the inclusion of the PL/I subroutine library in the 
new operating system. Complex object time functions are not to be included. 
This library is to be placed on the new system-residence volume. 



PL1LIB 
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PROCLIB 

The PROCLIB macro instruction specifies the inclusion of the procedure library 
(SYS 1. PROCLIB) in the new operating system. This macro instruction is optional, 

Basic Requirements 

• The SYS 1. PROCLIB data set must have space allocated for it. It may be 

cataloged in the new system during the preparation for system generation. 

• If IBM-supplied cataloged procedures are going to be used, the group names 
used by these procedures must be defined by UNITNAME macro instructions. 

• This macro instruction can be used with an MVT generating system to include 
the IBM-distributed SYS 1. PROCLIB if a user-assigned qualifier is specified 
in the INDEX parameter of the GENERATE macro instruction. 

• If this macro instruction is not coded, a null data set must be defined 
and available to the new system. 

• The CRJE macro instruction is required to support conversational remote 
job entry facility. 

Processor/Library Generation 

• If a null SYS 1. PROCLIB is going to be replaced, it must be scratched and 
uncataloged before the new SYS1. PROCLIB is initialized. 



Name Operation Operand 
PROCLIB 



[UNIT=name | 
VOLNO=serialJ 



Default: If the keyword parameters UNIT and VOLNO are not coded, the procedure 
library for the new system is placed on the system-residence volume. 

ONIT= 

specifies the direct-access device that will contain the volume on which 
the procedure library will be generated. 

name 

Note: 




Required: If this keyword parameter is coded, VOLNO must be coded. 

VOLNO= 

specifies the serial number of the volume that is to contain the procedure 
library for the new system. 

serial 

is the serial number. 
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Notes: 

• Required: If this keyword parameter is coded, UNIT must be coded. 

• Value: The value specified must be the same as that specified in the 
VOLUME keyword parameter of the DD statement used to allocate space for 
SYS1.PS0CLIB. 

Coding Hints and Additional Information 

This example illustrates the use of the PHOCLIB macro instruction to specify 
the inclusion of the procedure library in the new operating system. The unit 
name is 2311. The volume serial number is 909090. 

PHOCLIB UNIT=2311,VOLNO=909090 
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PTOP 

The PTOP macro instruction specifies the inclusion of processor-to-processor 
support for transmitting data between the operating system and an IBM 1130 
Disk Monitor System. This macro instruction is optional. 

Basic Requirements 

• UNIT=1130 and ADAPTER=BSCA must be specified in the IODEVICE macro 
instruction. 

• ACSMETH=BTAM must be specified in the DATAMGT macro instruction. 

• SYS1.TELCMLIB must be specified with the TELCMLIB macro instruction. 

Processor/Library Generation 

• UNIT=113C and ADAPTER=BSCA in the IODEVICE macro instruction, ACSMETH=BTAM 
in the DATAMGT macro instruction, and the TELCMLIB macro instruction must 
have been specified during a complete generation. 

• The FORTLIB macro instruction must be used to indicate where SIS1.FORTLIB 
resides if LIB=FORTLIB is specified and whether or not SYS 1. FORTLIB was 
specified during an earlier generation, or is not on the system-residence 
volume. 

Name Operation Operand 

PTOP [LIB= {FORTLIB}] 

(LINKLIB} 

LIB= 

specifies the library that will contain the System/360-1130 data 
transmission processor-to-processor routines. 

FORTLIB 

specifies that the data transmission routines are placed in 
SYS1. FORTLIB and SYS1. LINKLIB. 

Note: The FORTLIB macro instruction must also be specified. 

LINKLIB 

specifies that the data transmission routines are placed in 
SYS 1. LINKLIB. 

Default: If this keyword parameter is omitted, FORTLIB is assumed. 

Note: 

The PTOP macro instruction places the System/360-113 data transmission modules 
into libraries (SYS1 .FORTLIB and SYS1. LINKLIB) from which your calls to data 
transmission and data conversion subroutines can be resolved most efficiently. 
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Coding Hints and Additional Information 

The following example illustrates the use of the PTOP macro instruction to 
specify inclusion of processor-to-processor support in the new operating system. 
The System/360-1130 data transmission routines will be placed in SYS1.F0RTLIB. 

PTOP 

The second example provides another illustration of the use of the PTOP macro 
instruction specifying the inclusion of processor- to- processor support in the 
new operating system. The System/360-1130 data transmission routines will 
be placed in SYS1.LINKLIB. 

PTOP LIB=LINKLIB 
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RESMODS 

The RESMODS macro instruction adds user-written routines, in load module or 
object module form, to the nucleus library ( SYS 1 .NUCLEUS) to be generated. 
This macro instruction is optional. 

Basic Requirements 

• The modules to be included must be members of a partitioned data set. 

• The data set that contains the modules must be cataloged in the generating 
system as SYS 1. name. 

Nucleus Generation 

• Sufficient space must have been allocated to SYS1. NUCLEUS during the 
preparation for a complete generation. 

Name Operation Operand 

RESMODS PDS=SYS1.name 

MEMBERS* (name[ ,name]. . .) 

PDS= 

specifies the partitioned data set that contains the modules to be 
included. 

SYS1. name 

is one to eight alphameric characters, the first of which is 
alphabetic. 

MEMBERS* 

specifies the simple names of the members to be included. 

name 

is one to eight alphameric characters, the first of which is 
alphabetic. 

Notes: 



• Maximum ; A maximum of ten modules can be included in the nucleus. 

• SYC Routines; If resident SVC routines are being included, each 

module can contain more than one SVC routine. The type, number, and SVRB 
extended save area of each of the resident SVC routines to be included 
must be specified in the SVCTABLE macro instruction. (For further 
information on writing your own SVC routines, refer to OS MFT Guide or 
OS MVT Guide. ) 

Coding Hints and Additional Information 

This example illustrates the use of the RESMODS macro instruction to include 
the CONTROL and IORTN load modules in the nucleus library. These modules are 
members of the SYS 1. NEW partitioned data set. 

RESMODS PDS=S YS 1 . NEW , MEMBERS* (CONTROL, IORTN) 
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RPG 

The RPG macro instruction specifies the inclusion of the report program 
generator (RPG) language processor. This macro instruction is optional, 

Processor/Library Generation 

• Sufficient space must have been allocated for the RPG processor in 
SYS1.LINKLIB. 

Name Operation Operand 
RPG 



Coding Hints and Additional Information 

IESRPG is the name and RPG is the alias of the RPG language processor. 

Example; The following example illustrates the use of the RPG macro instruction 
to specify the RPG language processor. 

RPG 
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SCHEDULE 



The SCHEDULE macro instruction specifies the job scheduler options, 
instruction is required. 



This macro 



Nucleus Generation 

• This macro instruction must be specified. 

• Only WTOBFRS and REPLY can be changed. 

• All other parameters must be respecified exactly as they were during the 
last complete generation. 

Processor/Library Generation: 

• This macro instruction must be specified only if the TSO option is 
specified. 

• All keyword parameters and their subparameters must be specified in exactly 
the same way as they were during the last complete operating system 
generation. 

I/O Device Generation 

• This macro instruction must be specified. 

• The CONSOLE and ALTCONS parameters can be changed. The primary, master, 
and alternate console addresses may be changed. No other parameters can 
be changed and must be respecified in exactly the same way as they were 
during the last complete generation. 

• The addresses specified in the STARTS, STARTW, PROCRES, and JOBQRES 
parameters must be the same as those specified in the last complete 
generation, but they can be changed at IPL time. 



Name 



Operation 
SCHEDULR 



Operand 

For TYPE=MFT 

TYPE=MFT 

[ OPTIONS* ([ f LOG. )][,][ CRJE ][ , ][ R JE ]) ] 
{ NO LOG J 
STARTR=(A-address[ ,7-serial][ ,D-dsname]) ] 
" STARTW* (A-address[ ,v-serial][ , D-dsname]) 3 
fNOTSUPPLIED]" 1 
ACCTRTN* BASIC 
I.SHF 
' VLMOUNT=AVR ] 
'80011 



TAVR= 



200 
556 J. 



DESIGN= f30K|1 

UukJJ 
" starti* [ manual }] 

\AUTO J J 
WTOBFRS=number ] 
REPLY«number] 
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Name 



Operation 



Operand 



SCHEDULR 
(Cont.) 



EVA= 



For TYPE=ttFT (Continued) 

[ PROCRES=address ] 
[ JOBQRES=address ] 
[ JOBQFMT=number ] 
[ JOBQLMT=number ] 
[ JOBQTMT=number ] 

f— Vl 

ESV= /NO > 

(smf)J 

\(n^n2)/J 

\ JOBQWTP=number ] 
WTLCLSS=classname ] 
WTLBFRS=number ] 
MINPART=number] 
CONOPTS=(NOMCS 

< (MCS f, NOEXIT ) )' 
I UEXIT / 

If CONOPTS=NOMCS is specified: 
CONSOLE=.faddress ) 

\ (I-address r O-address) / 
f"ALTCONS= iaddress Y\ 

I \ (l-address,0-address) jj 

If CONOPTS=MCS is specified: 

faddress ) 

V(I-address,0-address) f 
(address | 

1(I-address,0-address) f 
ROUTCDE= n 11 

((routine code[ , routing code]...)/J 
;0LDWT0R= (routing code[ , routing code]...)] 
* AREA= (nn[ ,nn... ]) ] 
HARDCPY=(JSYSLOG ) 
(address/ 
ALL ) 

code[ , routing code]...)/ 



fl 



ALTCONS= 



(, (routing 
;nocmds\ 



{ 



,INCMDSf 
,STCMDS( 
,CMDS / 

[0PSTRAN=nn] 

[PFK=nn] 



For TYPE=HVT 



TYPE=MVT 

[ OPTIONS^ ([ JLQG l][,][CRJE] 
(NOLOGj 
[r][RJE][,][TSO]) ] 

; STARTR= (A-address[ ,V-serial][ ,D-dsname]) ] 
' STARTW= (A-address[ , V-serial ][ , D-dsname ]) ] 

!NOTSUPPLIED)~| 
BASIC > 

SMF JJ 
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Name 



Operation 

SCHEDOLR 
(Cont.) 



Operand 

For TYPE=MVT (Continued) 



VLMOUNT=AVR] 

(800)1 
TAVR=<200> 
(556) 
fSTARTI= / MANU AL 
(AUTO 



}] 



taxi 

1] 



ifl 



WTOBFRS=number ] 

REPLY=number ] 
; PROCRES=address ] 
; JOBQRES=address ] 
; JOBQFMT=number ] 
; JOBQLMT=number ] 
; JOBQTMT=number ] 

SUBMITQ=maxno ] 

! CON 
NO 
smf]_ 

EVA= /NO Y] 

UnSn2)fJ . 
; JOBQWTP=number ] 
WTLCLSS=classname ] 
tWTLBFRS=number] 
INITQBF=nuir l ber] 
' MINPART=number ] 
CONOPTS= ( NOMCS 

< (MCS/,NOEXITl 
( \,EXIT 

If CONOPTS=NOMCS is specified: 
CONSOLE=faddress ) 

\ (I-address,0-address)J 
fALTCONS=(address )"| 

[ \ (I-address,0-address)/J 

If CONOPTS=HCS is specified: 
CONSOLE=/address ) 

\ (l-address,0-address)/ 
ALTCONS= /address ) 

\ (l-address,0-address)/ 
ROOTCDE= h VI 

((routing code[ , routing code]...)/J 
OLDWTOR= (routing code[ , routing code]...)] 
' AREA= (nn[ ,nn. . . ]) ] 
HARDCPY=(/SYSLOG ) 
(address) 
/,ALL ) 

' , (routing code[ , routing code]...)/ 
r , NOCMDS r 
,INCMDS 
,STCMDS 
,CMDS 
[OPSTRAN=nn] 
PFK=nn] 



SCHEDULR 
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Name 



Operation 

SCHEDULE 
(Cont.) 



Operand 

For TYPE=M65HP 



TYPE=M65MP 
[ OPTIONS= 



(C/LOG H[,][CRJE][,][RJE][TSO]) ] 
\N0L0GJ 



ill 



[ STARTR= (A-address[ , V-serial ][ , D-dsname ]) ] 

[ STARTW= (A-address[ , V-serial ][ , D-dsname]) ] 

r (NOTSOPPLIED)l 

ACCTRTN=<BASIC > 

[ VLM0UNT=AVR ] 

! 800 ] 
200 

STARTI^j BAHPAL H 

WTOBFRS=number ] 

REPLI=number ] 

PROCRES=saddress ] 
; JOBQRES=address ] 

JOBQFMT=number ] 

JOBQLMT=number ] 
[JOBQTMT=number] 

J— ll 

ESV= <N0 > 

I SMF) J 
EVA= /NO H 

\ (n»,n*)fj 
; JOBQWTP-number ] 
; 9TLCLSS=classname ] 
" WTLBFRS=number ] 
INITQBF^number] 
[MINPART=number] 
CONOPTS= (NOMCS 

< (MCS L NOEXIT 

( I, EXIT 

If CONOPTS=NOMCS is specified: 

CONSOLE= ((address \ 

lI-address,0-addressj 

/, address \ 

(,I-address,0-address J ) 



r)] 



ALTCONS= ((address 

\ l-address,0-address 
/, address 
I ,1- 



} 



If CONOPTS=WCS is 
CO NSOLE= /address 

1 (I-ad dress, 0- address) 
ALTC0NS=|address 

1 (I-ad dress, O-address) 



address , O-address 
specified: 

} 



}.J 
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Name 



Operation 

SCHEDULR 
(Cont.) 



Operand 

For TYPE=H65«P (Continued) 

ROOTCDE^n n 

\ (routing cod e[ , routing code ]...)/ J 
; OLDWTOR* (routing code[ , routing code]...)] 
' AREA= (nn[ ,nn. . . ]) ] 
HARDCPY=(JSYSL0G ) 
(address f 
f,ALL \ 

\ , (routing code[ , routing code]...)/ 
/,NOCMDS\ 
f ,INCHDS ! 
| ,STCMDS I 
\,CMDS / 
OPSTRAN=nn] 
[PFK=nn] 



AREA= 

specifies the dimensions of the display areas to be set aside for status 
displays on the display console screen specified in the CONSOLE* operand. 

nn 

is a decimal "number egual to the number of display screen lines to 
be in the display area. The minimum specification is four lines; 
the maximum specification is the number of lines in the message area 
of the defined display area. Each nn defines one display area of 
the size indicated. The first nn defines the bottom-most display 
area on the screen (the bottom lines of the message area) . Subsequent 
nn's define areas stacked above the bottom-most area working toward 
the top of the screen. 

Default: If this parameter is not specified when a display console is specified 
in the CONSOLE* operand, the system defaults one display area for that console. 
The size of the display area depends on the type of console specified. Display 
area default sizes for the various types of display consoles are as follows: 



Console 



Number of Lines 



2250 




14 


2260 




8 


3277 Model 2 




14 


Consoles for Models 85, 


165, 




91, or 195 




14 


Notes : 








The 3277 Model 1 area parameter is not valid. 

The AREA parameter reserves 36 bytes of storage in the nucleus for each 
area defined. The areas defined become the default during each IPL. 
Areas may also be added by the operator after IPL. The storage required 
for these additional areas (32 bytes per area) is obtained dynamically 
from the system queue area (SQA) . The AREA parameter should be used to 
define the areas to be used in a normal case, not the possible maximum. 
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ACCTRTN= 

specifies whether you are supplying an accounting routine. 

NOTSOPPLIED (For all types) 

specifies that you do not intend to provide an accounting routine. 

BASIC (For all types) 

specifies that you are supplying accounting routines. 

Notes: 

These routines should be placed in SYS1.CI505 before the system generation 
process is started. (For further information on the accounting routines, 
refer to the appropriate section in the OS HFT Guide or OS MVT Guide. ) 

SMF (For all types) 

specifies that the system management facilities (SMF) routines are 
to be included. 

Default: If ESV=SMF has been specified, this subparameter becomes the 
default for ACCTRN. 



Notes: 



• MFT and MVT ; BSAM modules (IGG019BA, IGG019BB, IGG019CD) must be 
resident if SMF data sets are on direct-access devices. When SMF 
recording is on tape, BSAM modules (IGG019BA, IGG019BB, IGG019CC, 
and IGG019BD) must be made resident. 

• Reguired: For HFT or MVT, TIMER=JOBSTEP must be specified in the 
SUPRVSOR macro instruction if this option is specified. 

• User-written routines: These can be added to SMF by means of the 
exits provided. These routines should be placed in SYS1.CI505 before 
the system generation process is started. If user-written routines 
are added to the system for the IEFUJI, IEFUSI, and/or IEFACTRT exits, 
the sizes of these modules must be added to the size specified in 

the MINPART keyword parameter. (For further information on the exit 
routines, refer to the appropriate section in the OS MFT Guide or 
OS MVT Guide. ) 

• Data Sets: If this subparameter is specified, both SMF data sets 
must be allocated space and cataloged in the new system (if they are 
on direct-access devices) . 

Defaults: 

• If this keyword parameter is omitted and ESV=SMF is not specified, 
NOTSUPPLIED is assumed. 

• If ESV=SMF is specified, ACCTRTN=SMF is assumed. 
Notes: 

• MFT: TIMER=JOBSTEP must also be specified in the SUPRVSOR macro instruction 
if the job-step CPU timing feature of MFT is desired. 

• Included: Specifying this keyword parameter results in the inclusion of 
the module that is the access to the SYS1.ACCT data set. 
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ALTCONS= (For all types) 

specifies that a device is to be used as an alternate console. 

address 

is the unit address of an alternate console. 

Note: 

MCS: If the multiple console support (HCS) option is specified, this 
device must have input and output capability. 

I-address 

is the unit address of an input device for a composite console. 

O-address 

is the unit address of an output device for a composite console. 

Notes: 

• Required: This keyword parameter must be specified if HCS is included 
in the new system. 

• Acceptable Devices: Each unit address used must be the same as that 
specified for the device in an IODEVICE macro instruction. The devices 
that can be used are listed in Figure 8ft. 

• HCS: A device specified as a part of a composite console cannot be 
specified in any other way, that is, as a single device or as a part of 

a composite console with a different companion device. However, the same 
combination can be repeated more than once. 

CONOPTS= (For all types) 

specifies the console options desired. 

NOHCS 

specifies that HCS is not desired. 

Default: If this keyword parameter is omitted, this subparameter and 
NOEXIT are assumed. 

HCS 

specifies that HCS is desired. 

Notes: 

• Required: If HCS is specified, the device specified in the ALTCONS 
parameter of this macro instruction must also be specified in the 
CONSOLE parameter of a SECONSLE macro instruction. 

• Optional: If HCS is specified, then the following subparameters may 
be used. 

EXIT 

specifies that a user exit is desired before the routing code of the 
write-to-operator (WTO and WTOR) message is used to send it to the 
appropriate consoles. 

NOEXIT 

specifies that no user exit is desired. 

Default: If this keyword parameter is omitted, NOHCS and NOEXIT are assumed. 
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CONSOLE^ (For all types) 

specifies the primary console, or, if the multiple console support (MCS) 
option is specified, the master console. 

address 

is the unit address. If MCS is specified, the device must have input 
and output capability. 

I-address 

is the unit address of an input device for a composite console. 

O-address 

is the unit address of an output device for a composite console. 

Notes: 



• Acceptable Devices: Each unit address used must be the same as that 
specified for the device in an IODEVICE macro instruction. The devices 
that can be used are listed in Figure 84. 

• MCS: Any device specified as part of a composite console cannot be 
specified in any other way, that is, as a single device or as a part of 

a composite console with a different companion device. However, the same 
combination can be repeated more than once. 

DESIGN= (For MFT) 

specifies the design level (in bytes) of the MFT job scheduler. 

EVA= (For all types) 

specifies the use of and threshold values for error volume analysis (EVA). 

NO 

specifies that EVA will not be used. 

n*,n 2 

are integers from 1 to 254. 

ni 

is the number of temporary read errors' that cause an ESV message 
to be printed on the console. 

n« 

is the number of temporary write errors that cause an EST message 
to be printed on the console. 

Default: If this keyword parameter is omitted, EVA is not included in the 
operating system. 

ESV= 

specifies the destination of volume error statistics records. 

NO (For all types) 

specifies that the records will not be constructed. 

CON (For all types) 

specifies that an abridged version of the records will be constructed 
and put on the console. 
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SMF (For all types) 

specifies that the records will be constructed and written on the 
SMF data sets, SYS1.MANX or SYS1.MANY. 

Notes: 

• Requirements: ACCTRTN=SMF should be specified. If it is not 
specified, it is assumed. 

• MFT and MVT Systems: TIMER=JOBSTEP must be specified in the SOPRVSOR 
macro instruction. 

Default: If this parameter keyword is omitted, ESV=CON is assumed. 

HARDCPY* (For all types) 

specifies that a hard-copy log will be used to record operator commands, 
system commands and responses, and write-to-operator (WTO and WTOR) 
messages. 

Note : CONTROL (K) commands, which control console functions rather than 
system functions, are not recorded on the hard-copy log. 

SYSLOG 

specifies that the data that is supposed to go to the hard-copy log 
will now go to the system log. 

Notes: 

• If this subparameter is specified, it must be changed temporarily 
at IPL time to the address of an operator console that has output 
capability. For a general description, see the "Program Options 
Descriptions" section. For detailed operating instructions, see OS 
Operator's Reference. 

• Dse: The data for the hard-copy log is handled in the same way as 
the data for the system log. (See WTLBFRS parameter description.) 

address 

is the unit address of a device with at least output capability that 
is used as the hard-copy log. (See Figure 84 for the devices that can 
be used.) 



Notes: 



ALL 



Restriction: A graphic device cannot be specified as the hard-copy 
log. 

Address: The unit address used must be that specified for the device 
in an IODEVICE macro instruction. 

Required: This device must also be specified either in the CONSOLE 
parameter of the SCHEDOLR macro instruction or in a SECONSLE macro 
instruction. 

specifies that all write-to-operator (WTO and WTOR) messages are to 
be put in the hard-copy log. 




routing code 

is a number from 1 to 16 that designates the routing code that the 
hard-copy log is authorized to receive. 

Note: 

For detailed information about routing codes, see OS Supervisor Services 
and Macro Instructions. 
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NOCMDS 

no operator or system commands or responses are desired. This option is 
ignored if the hard-copy log is mandatory. 

INCMDS 

the operator and system commands and responses (but not status displays) 
are to be written on the hard-copy log. 

STCMDS 

the operator and system commands, responses, and status displays (except 
time-interval updated status displays) are to be written on the hard-copy 
log. 

CMDS 

the operator and system commands, responses and status displays (static 
and time-interval updated) are to be written on the hard-copy log. 

Default: CMDS is assumed if none of the above four subparameters are specified 
or if NOCMD has been specified in a system for which the hard-copy log is 
mandatory . 

Default; If this keyword parameter is omitted, ALL and NOCHDS is assumed. 

Notes: 

• Reguired: This keyword parameter can be used only if CONOPTS=MCS has been 
specified. 

• Graphic Console: When a graphic console is active or if there is more 
than one active console, a hard-copy log will be reguired during system 
initialization or job execution time. 

• Coding: The subparameters for HARDCPY are positional and must be coded 
in the sequence shown in the macro instruction format provided at the 
beginning of the macro instruction description. For any subparameter 
omitted, a comma must be written to indicate its absence. For example, 
HARPCPY* (, ALL, CMDS) indicates the absence of the unit address subparameter. 

INITQBF= (For HVT including M65MP) 

specifies the number of buffers in main storage that will hold logical 
tracks from SYS1 .SYSJOBQE. 

number 

is an integer from to 255 that is the number of 1024-byte buffers 
to be set up in main storage. Use the following formula: 

INITQBF = 88+37«N+L(8+176«H) 

mV ' 

N 

is the number of 176- byte records in a logical track of 

SYS 1. SYSJOBQE. This value is specified in the keyword parameter 

JOBQFMT. 

L 

is the number of logical tracks to be in main storage at any 
one time. 

Note: Round off the value to the next highest multiple of 1024. 
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Notes: 

• For further information about specifying the system job queue, see OS 
Storage Estimates. 

• Track Stacking: The method used to handle the data brought in from 
SYS1 . SYSJOBQE is called track stacking. Track stacking permits one or 
more logical tracks for a particular job to reside temporarily in main 
storage as an ordered series. 

• Change Value: This number can be changed by the operator at IPL time if 
OPTIONS=COMM is specified in the SUPRVSOR macro instruction. 

JOBQFMT= (For all types) 

specifies the size of each logical track for SYS 1. SYSJOBQE. 

number 

is an integer from 10 to 255 that is the total number of 176-byte 
records in each logical track. 

Default: If this keyword parameter is omitted, a value of 12 is assumed. 

Notes: 

• Change Value: This value can be changed by the operator at IPL time if 
OPTIONS=COMM is specified in the SUPRVSOR macro instruction. (For detailed 
information about specifying a value for this parameter, see OS HFT Guide 
or OS MVT Guide. ) 

• SMF: If SMF is specified in the ACCTRTN keyword parameter, then the value 
must be increased by two additional messages per job and per step. 

JOBQLMT= (For all types) 

specifies the number of 176-byte records in SYS1 . SYSJOBQE to be reserved 
for each initiator started. 

number 

is an integer less than or equal to 9999. 

Default: If this keyword parameter is omitted, a value of 60 is assumed. 

Notes: 

• Change Value: The value can be changed at IPL time if OPTIONS=COMM is 
specified in the SUPRVSOR macro instruction. Refer to OS MFT Guide or 
OS MVT Guide information about how to specify a value for this parameter. 

• Size: A job is terminated if the number of records required to initiate 
it exceeds the value specified. It is recommended that the value specified" 
for JOBQLMT be a multiple of the value given to JOBQFMT. 

JOBQRES= (For all types) 

specifies the device on which SYS 1. SYSJOBQE resides. (This keyword 
parameter is not used if SYS1 . SYSJOBQE was cataloged.) 

address 

is the address of the device. 

Default: If this keyword parameter is omitted and SYS1. SYSJOBQE was not 
cataloged, the address of the system-residence device is assumed. 
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Notes: 

• Value: The address must be the same as that specified for the device in 
the IODEVICE macro instruction. 

* Change Value: This address can be changed at IPL time. 

JOBQTMT= (For all types) 

specifies the number of 176-byte records in STS1. SISJOBQE to be reserved 
for the termination of jobs that require more records for initiation than 
those specified in JOBQLMT. 

number 

is an integer less than or equal to 9999. 

Default: If this keyword parameter is omitted, a value of 60 is assumed. 

Note: 



Change Value: This number can be changed at IPL time if OPTIONS=COMM is 
specified in the SUPRVSOR macro instruction. Refer to OS MFT Guide or OS MVT 
Guide for information about how to specify a value for this parameter. 

JOBQWTP** (For all types) 

specifies the number of 161-byte SYSJOBQE records that the write-to- 
programmer routine can use for messages during a job. 

number 

is a number from to 20. 

Default: If this keyword parameter is omitted, a value of 2 is assumed. 

Notes: 

• An additional two records are reserved specifically for system messages. 
These two records are used after the specified limit is reached during 

a job. (See OS MFT Guide or OS MVT Guide for information about specifying 
the value.) 

• HFT and MVT: This value can be changed at IPL time if OPTIONS=COMM is 
specified in the SUPRVSOR macro instruction. (See OS Operator*s Reference 
and OS Messages and Codes for information about changing values at IPL 
time.) 

MINPART= (For all types) 

specifies the number of 1024-byte blocks of main storage required for the 
minimum size region or partition in which to initiate a job. 

number 

MFT: It must be a decimal number equal to or greater than the value 
specified in the DESIGN keyword parameter. 

MVT including M65MP: It must be a decimal number equal to or greater 
than 52 ♦ the value of INITQBF. 

Defaults: 



MFT: If the number is less than the value in DESIGN, then the value in 
the DESIGN keyword parameter is used and a warning message is issued. 
If the DESIGN keyword parameter is omitted, the default value for DESIGN 
is used. 
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• MYT including M65MP; If this keyword parameter is omitted and the keyword 
INITQBF is omitted, then a value of 52 is assumed for HINPART. If this 
keyword is omitted and the keyword INITQBF is specified, then MINPART is 
given the value of 52 plus the value of INITQBF. 

Notes: 

• Yalue Change; This number can be changed at IPL time. 

• SMF; If your own routines for the IEFUJI, IBFUSI, and/or IEFACTRT exits 
are going to be included in the system, the size(s) of these routines must 
be added to the value specified in this keyword parameter. 

OLDWTOR= (For all types) 

specifies the routing code to be assigned to all write-to-operator (WTO 
and WTOR) messages that do not already have routing and descriptor codes. 

routing code 

is a number from 1 to 16. 

Default; If this keyword parameter is omitted, the master console receives 
all WTO and WTOR messages that do not have routing and descriptor codes. 

Notes; 

• For detailed information about the descriptor and routing codes, see OS 
Supervisor Services and Macro Instructions. 

• Required: This keyword parameter can be used only if CONOPTS*MCS has been 
specified. 

• Specifying a routing code of 11 will not make the messages into WTP messages 
to the system message class. Default routing codes apply only to consoles. 

OPSTRAN= (For all types) 

specifies the transient Display Control Module (DCM) group to which the 
display (CRT) console, specified in the CONSOLE= parameter, is assigned. 
OPSTRAN applies only to display consoles. 



nn 



Notes: 



is a decimal number from 1 to 32 selected by the user. 



Required: This keyword parameter can be used only if CONOPTS=MCS has 
been specified. 

If the OPSTRAN«nn parameter is not specified, each Display Control Module 
(DCM) must be resident in main storage at all times. 

If the OPSTRAN^nn parameter is specified, up to four consoles may be 
assigned to a transient group. 

Display Control Modules (DCHs) are control blocks that contain system 
information required for display (CRT) consoles. Each display console 
has its own DCM. For further information about DCHs, see OS MET Supervisor 
Logic or OS MYT Supervisor Logic. 

The use of transient DCMs can reduce resident storage requirements 
associated with display consoles. Any type of display console can operate 
from a transient area, but the master console, its alternate, and other 
high message consoles perform with greater speed if they are not assigned 
to a transient area. Transient DCMs work to greatest advantage for consoles 
with lower than average message activity. 
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OPTIONS= 

specifies job scheduler and system log options. These values may be listed 
in any order. 

CRJE (For all types) 

specifies inclusion of conversational remote job entry (CRJE) . 

Notes: 

• If this subparameter is specified, BTAM must be specified in the 
DATAMGT macro instruction. 

• For detailed information about CRJE, see OS CRJE System Programmer's 
Guide. For a general description see the "Program Options 
Descriptions" section in this publication. 

LOG (For all types) 

specifies that a system log is desired. 



Notes: 

• Required: If this subparameter is specified, the data sets 

SYS1 .SYSVLOGX and SYS1.SYSVL0GY must be cataloged in the new system. 

• MFT: If this subparameter is specified for an MFT system, BSAM modules 
(IGG019BA, IGG019BB, IGG019CD) must be resident in the system. 

NOLOG (For all types) 

specifies that no system log is desired. 

Note: This subparameter cannot be specified if HARDCPY=SYSLOG has been 
specified. 

RJE (For all types) 

specifies the inclusion of remote job entry. 

Note: If RJE is specified, BDAM and BTAM must be specified with the DATAMGT 
macro instruction. (For further information on this parameter, refer to 
the publication OS RJE. For a general description, see the "Program Options 
Descriptions" section in this publication.) 

TSO (For MVT including M65MP) 

specifies the inclusion of the OS Time-Sharing Option. TYPE=MVT or 
TYPE=M65MP must be specified. 

Default: If this keyword parameter is omitted or NOLOG is not specified, LOG 
is assumed. 

Note: If this keyword parameter is specified, a comma must not precede the 
first or only subparameter. 

PROCRES= (For all types) 

specifies the device on which SYS1.PR0CLIB resides. (This keyword parameter 
is not used if SYS1.PR0CLIB was cataloged.) 

address 

is the address of the device. 

Default: If this keyword parameter is omitted and SYS1.PR0CLIB was not 
cataloged, the address of the system-residence device is assumed. 
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Notes: 

• Value; The address must be the same as that specified for the device in 
the IODEVICE macro instruction, 

• Change Value: This address can be changed at IPL time if OPTIONS=COMM 
has been specified in the SUPRVSOR macro instruction. 

PFK= (For all types) 

specifies that the console is to have programmed-function-keyboard (PFK) 
command entry and/or light pen command entry. 

nn 

is a decimal number from 1 to 12 indicating the number of PFK keys 
or key numbers to be associated with operator commands. 

Notes: 

• Required: This keyword parameter can be used only if CONOPTS=MCS has 
been specified. 

• PFK command entry applies only to display (CRT) consoles. The specified 
console must have either a PFK or, light pen attached. The number indicated 
by nn specifies: 

the number of PFK keys that the operator can associate with commands after 
IPL, or 

the number of light-pen-detectable numerical indicators in the PFK line 
of the screen that the operator can associate with commands after IPL. 

If the specified console has both a PFK and a light pen, both methods of 
command entry will be made available when the PFK macro is specified. 
For further information about PFK and light-pen command entry, refer to 
OS Operator's Guide for Display Consoles. 

REPLY= (For all types) 

number 

is the number of reply queue elements to be used by the WTOR routines. 
Each reply queue element is 24 bytes. 

Defaults: 



If this keyword parameter is omitted, the following values are assumed: 

For MVT 
For MFT (including M65MP) 

10 20 
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• If the EMULATOR macro instruction is specified, do not specify fewer 
reply queue elements than the default. 

Note: 

Emulator: For each additional emulator generated, one additional reply queue 
element must be specified. This is not done if only one emulator is executing 
at a time. 

ROUTCDE= (For all types) 

specifies which routing codes the master console is authorized to receive. 

routing code 

is a number from 1 to 16. 

Default: If this keyword parameter is omitted, only routing codes 1 and 2 
are recognized by the master console. 

Notes: 

• Required: This keyword parameter can only be used if CONOPTS=MCS has been 
specified. 

• Routing codes 1 and 2 are always assigned automatically. (For detailed 
information about the routing codes, see OS Supervisor Services and Macro 
Instructions. ) 

STARTI= (For all types) 

specifies whether a START INIT (ALL) command for HFT, or a START INIT 
command for MVT (including H65MP) is to be executed automatically each 
time the new operating system is loaded into main storage after IPL. 

AUTO 

specifies that the command is executed automatically. 

MANUAL 

specifies that the command is not executed automatically. 

STARTR= (For all types) 

specifies that a START RDR command is executed automatically each time 
the new operating sytem is loaded into main storage after IPL. 

A-address 

is the unit address of the I/O device to be started. 

Note: This address value must be the same as that specified for the device 
in the IODEViCE macro instruction. 

V-serial 

is the serial number of the labeled volume associated with the device. 

D-dsname 

is the data set name associated with the device to be started. The 
dsname must be from 1 to 8 characters. 
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STARTW= (For all types) 

specifies that a START WTR command is executed automatically each time 
the new operating sytem is loaded into main storage after IPL. 

A-address 

is the unit address of the device to be started. 

Note: This address value must be the same as that specified for the device 
in the IODEVICE macro instruction. 

V* serial 

is the serial number of the labeled volume associated with the device. 

D-dsname 

is the name of the data set associated with the device to be started. 
The dsname must be from 1 to 8 characters. 

SUBMITQ= (for TSO) 

specifies the maximum number of logical tracks to be reserved for TSO 
foreground-initiated background (FIB) jobs in the system job gueue. 

maxno 

is an integer from to 9999. 

Default: If this keyword parameter is omitted, 50 logical tracks are assumed. 

TAVR= (For all types) 

specifies the standard density for 7-track magnetic tape volumes used with 
automatic volume recognition (AVR) . 

Default: If this keyword parameter is omitted, 800 BPI is assumed. 

Note: 



This keyword parameter may be specified only if VLMOONT=AVR has been coded. 

TTPE= 

specifies the type of job scheduler. 

MFT 

specifies the multiprogramming with a fixed number of tasks job 
scheduler. It must not be specified for TSO systems. 

MVT 

specifies the multiprogramming with a variable number of tasks job 
scheduler. MVT may be specified for TSO systems. 

M65MP 

specifies the version of MVT that controls multiprocessing and uses 
two model 65s. M65MP may be specified for TSO systems. 

Note: 




Reguired: The value given to this keyword parameter must be the same as that 
specified for the TYPE keyword parameter in the CTRLPROG macro instruction. 

VLMO0NT= (For all types) 

specifies the volume mounting procedures. 

AVR 

specifies automatic volume recognition. 
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WTLBFRS- (For all types) 

specifies the size of the buffer area that is used as temporary storage 
for write-to-log (WTL) messages that will be written on SYS1 . SYSVLOGX or 
SYS1.SYSVL0GY. 

number 

is an integer 0, 4, or greater. 

Notes: 



• Size: The size of the area is determined by multiplying the number 
supplied by 148; 148 represents the maximum size of a WTL message. 

No matter what value is specified, the size of the area is not greater 
than twice the track size of the device type for which SYS 1. SYSVLOGX 
and SYS1.SYSVL0GY are cataloged. If these data sets reside on 
different device types, the smaller track size will be used in the 
calculation. 

• If is specified or this keyword parameter is omitted and 
OPTIONS=NOLOG is specified, all messages are written on the primary 
console, or the master console if the multiple console support (MCS) 
option is specified. 

• MCS: When MCS is specified in the CONOPTS keyword parameter and 
SYSLOG is specified in the HARDCPY keyword parameter, this number 
must be 4 or greater. 

• Error: If 0, 1, 2, or 3 is coded and OPTIONS=LOG is specified, 4 
will be substituted. 

• Maximum: The maximum number of buffers allowed is 255. 

• Optimum Number: Although each system has different system log 
reguirements, an optimum number of buffers for best log performance 
is from 10 to 15 buffers. 

Default: If this keyword parameter is omitted and OPTIONS=LOG is specified, 
a value of 4 is assumed. 

Note: 

• Use: When half of the buffer area is filled, a check is made to see if 
it can be written on either data set. If both data sets are unavailable, 
the contents of the buffer are held until one of the data sets is available. 
If all the buffers become full, any additional WTL messages are converted 
to write-to-operator (WTO) messages. Then they are written on the primary 
console (or the master console if the MCS option is specified) and on the 
hard-copy log if there is one. 

WTLCLSS= (For all types) 

specifies the classname to be used as a default for SYSOOT for write-to- 
log (WTL) messages. 

classname 

is a letter from A through Z, or a number from through 9. (If A 
is specified, SYSOOT and WTL messages will be interspersed.) 

Default: If this keyword parameter is omitted, L is assumed. 

WTOBFRS= (For all types) 

specifies the number of buffers to be used by the write-to-operator (WTO) 
routines. 

number 

is an integer or greater. 
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Defaults: 

• If MCS is not specified and this keyword parameter is omitted, the following 
values are assumed. 

Por MVT 
For MFT Including M65MP 

20 40 

• If CONOPTS=MCS is specified and the value is less than two buffers per 
console, then the specified value is ignored and two buffers per console 
are assigned. If this keyword parameter is omitted, two buffers are 
assumed for each operator's console in the system. 

• If the EMULATOR macro instruction is specified and the value specified 
for this keyword is less than 2, then two buffers are assigned. 

• If the WTOBFRS parameter is specified and the value is less than 3, and 
OPTION=ONLNTEST is specified in the SUPRVSOR macro instruction, a value 
of 3 is assumed. 

Notes; 

• Size: Each buffer will be 144-bytes long in a system that does not have 
MCS; each buffer will be 148-bytes long if the system has MCS. 

• This number should be at least equal to: three times the number of 
initiators expected to be active at any one time plus the maximum number 
of jobs that may be in the system at any one time. 

• HFT: If ONLNTEST is specified in the OPTIONS keyword parameter of the 
SUPRVSOR macro instruction, a minimum of three buffers is required. 

• For each additional emulator generated, you must specify one additional 
buffer. 

• You must specify additional buffers when display areas are defined for 
display console screens and/or when the MONITOR ACTIVE facility (applies 
only to display consoles) is used. You may use the following algorithm 
to calculate the number of buffers required: 

(28 x *sX) - Y = number of required buffers 

where: 

X = total number of defined display areas 

Y = total number of lines in all display areas planned for use by 
nondynamic status displays 
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Coding Hints and Additional Information 

The keyword parameters that are concerned with and affect SYS1.SYSJ0BQE are: 

INITQB — amount of storage to hold logical tracks 
JOBQFMT — size of logical track 

JOBQLMT — number of records reserved for each initiator 
JOBQRES — device for SYSJOBQE 

JOBQTMT ~ number of records reserved for termination 

SUBMITQ — (TSO) number of tracks reserved for foreground initiated background 
(FIB) jobs 

The chart below shows the relationships between parameters in this macro 
instruction. 



Parameter 
HARDCPY=SYSLOG 

MINPART 

SUBMITQ=maxno 
WTLBFRS 



Comment 

Cannot specify or allow 
to default if: 

If omitted value depends 
on: 

Can be specified only if: 

Value 4 or greater if: 



Parameter 

OPTIONS=NOLOG 

DESIGN 

OPTIONS=TSO 

CONOPTS=MCS and 
HARDCOPY=SYSLOG 



Subparameter Onit address of 

address 1052 Models 5, 6, or 7 



2150 



2250 



2260 



2740 



Model 1 with alphameric keyboard, 
character generator, and 4K or 8K 
buffer 



Model 3 with alphameric keyboard 
(Requires the GRAPHICS macro 
instruction' and the IODEVICE 
macro instruction — NOMSECT 
parameter.) 

Model (local attachment) with 
alphameric keyboard with a 
284 8 Model 3 that has the line 
addressing feature 

Model 1 with record checking 
feature or with optional interrupt 
feature. Only one per commun- 
ication line 



Notes 

Only Model 7 
can be used 
with MCS 



Can be used 
only with MCS; 
light pen is 
optional 

Can be used 
only with MCS; 
light pen is 
optional 



Can be used 
only with MCS 



Can be used 
only with MCS 



Figure 84 (Part 1 of 4) . Devices for Which Onit Addresses can be Specified in 

CONSOLE and ALTCONS Parameters of SCHEDOLR 
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Subparameter Unit address of: 

3066 System Console 



3210 Console Printer Keyboard 



3215 Console Printer Keyboard 



3277 Model 2 with keyboard 

3505 Reader 

3525 Card Punch 

5450 Console for Model 85 



Notes 

Can be used 

only with MCS 

for 

S/370 

Models 165 or 168 

Can be used 

only for 

S/370 

Models 135, 

145, 155, or 158 

Can be used 

only for 

S/370 

Models 135, 

145, 155, or 158 

Can be used only 
with MCS; selector 
pen is optional 



Must have reader 
feature 

Can be used 
only with MCS 



I-address 



1052 



Models 5, 6, or 7 



1442 Model N1 



2150 
2250 



2260 



2501 



Model 1 with alphameric keyboard, 
character generator, and 4K or 8K 
buffer 



Model 3 with alphameric keyboard 
(Requires the GRAPHICS macro 
instruction and the IODEVICE macro 
instruction — NUMSECT parameter.) 

Model (local attachment) with 
alphameric keyboard with a 
2848 Model 3 that has the line 
addressing feature. 



2520 

2540 Reader 



Only Model 7 
can be used 
with MCS 



Can be used 
only with MCS; 
light pen is 
optional 

Can be used 
only with MCS; 
light pen is 
optional 

Can be used 
only with MCS 



SCHEDULR 



Figure 84 (Part 2 of 4) . Devices for Which Unit Addresses can be Specified in 

CONSOLE and ALTCONS Parameters of SCHEDULR 
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Subparameter 



Unit Address of: 



Notes 



2740 Model 1 with record checking 

feature or with optional interrupt 
feature. Only one per commun- 
ication line 

3066 System Console 



3210 Console Printer Keyboard 



3215 Console Printer Keyboard 



3277 Hodel 2 with keyboard 

3505 Card Reader 

3525 Card Punch 

5450 Console for Model 85 



O-address or 1052 
address (in 
HARDCPY) 

1403 

1443 

2150 

2250 



Models 5, 6, or 7 



Model 1 with alphameric keyboard, 
character generator and 4K or 8K 
buffer 



Model 3 with alphameric keyboard 
(Requires the GRAPHICS macro 
instruction and the IODEVICE macro 
instruction — NUHSECT parameter.) 



Can be used 
only with MCS 



Can be used 

only with MCS 

for 

S/370 

Models 165 or 168 

Can be used 

only for 

S/370 

Models 135, 145, 

155, or 158 

Can be used 

only for 

S/370 

Models 135, 145 

155, or 158 

Can be used 
only with MCS; 
selector pen 
is optional 



Must have 
reader feature 

Can be used 
only with MCS 

Only Model 7 
can be used 
with MCS 



Can be used 
only with MCS; 
light pen is 
optional 

Can be used 
only with MCS; 
light pen is 
optional 
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Subparameter 



Unit Address of: 



Notes 



2260 Model (local attachment) with 
alphameric keyboard with a 
2848 Model 3 that has the line 
addressing feature 

2740 Model 1 with record checking 

feature or with optional interrupt 
feature. Only one per commun- 
icat ion line 



Can be used 
only with MCS 



Can be used 
only with MCS 



3066 



3210 



Can be used 
only with MCS 
for S/370 
Models 165 or 168. 
Cannot be used 
in the HARDCPY 
parameter 

Can be used 

only for 

S/370 

Models 135, 

145, 155, or 158 



3211 
3213 



Can be used 
only for S/370 
Model 158 



3215 



3277 Model 1 or 2 



3284 Model 1 or 2 



3286 Model 1 or 2 



5450 Console for Model 85 



Can be used 
only for S/370 
Models 135, 
145, 155, or 158 

Can be used 
only with MCS? 
cannot be used 
with HARDCPY 
parameter 

Can be used 
only with MCS 

Can be used 
only with MCS 

Can be used 
only with MCS 



SCHEDULR 



Figure 84 (Part 4 of 4) . Devices for Which Unit Addresses can be Specified in 

CONSOLE and ALTCONS Parameters of SCHEDULR 

SCHEDULR 

Examples; 

The following example illustrates the use of the SCHEDULR macro instruction 
to specify the MVT job scheduler required for multiprogramming with a variable 
number of tasks (MVT). The address of the primary console is 1A. A composite 
console is used as an alternative console; its input address is C0C and its 
output address is 00D. An accounting routine is not supplied. START RDR and 
START WTR commands are executed automatically after IPL. The devices to be 
started are assigned addresses 00E and OOF. WTO routines use 75 buffers and 
WTOR routines use 25 reply-queue elements. 



System Generation Macro Instructions 419 



A START INIT command is executed automatically after IPL. The classname for 
WTL messages is L. A maximum of 20 buffers are used for WTL messages. 
SYS1.SYSJ0BQE and SYS1.PROCLIB are located on the system-residence device. 
The format of SYS1.SYSJ0BQE will be twenty 176-byte records for each logical 
track. Eighty 176-byte records (4 logical tracks) are reserved for each 
initiator started, and eighty 176-byte records are reserved for the termination 
of jobs that require more than 80 records for initiation. Fifteen 1024-byte 
buffers are requested for SYS 1.SYSJOBQE. Sixty-seven 1024-byte blocks are 
required to process a job (fifty-two plus fifteen INITQBF buffers) . The master 
console is a display console, the screen has one display area, 10 lines in 
length. The console has a program function keyboard (PFK) and twelve PFK keys 
are designated for later association with operator commands. 

SCHEDULR TYPE=MVT,CONSOLE=01A,ALTCONS=(I-00C,O-00D) , 

STARTR=A-0 0E,STARTW=A-00F,WTOBFRS=75,REPLY=25, 

STARTI=AUTO,WTLBFRS=20,JOBQFMT=20,JOBQLMT=80, 

JOBQTMT=80,INITQBF=15,MINPART=67,AREA=10,PFK=12 

The following example illustrates the use of the SCHEDULR macro instruction 
to specify the MVT job scheduler required for multiprogramming with a variable 
number of tasks (MVT) . The multiple console support option is specified in 
the CONOPTS parameter and the system log is specified in the OPTIONS parameter. 
The WTOBFRS parameter specifies that 80 buffers are used by the WTO routines, 
and the REPLY parameter specifies that 18 reply-queue elements are used by 
the WTOR routines. 

The master console is a composite console whose input address is 00C and whose 
output address is 01B. The alternate console is a device with input and output 
capabilities whose address is 00 A. The ROUTCDE parameter indicates that the 
master console or its alternate accepts routing codes with number 1, 2, 4, 
5 or 9. The OLDWTOR parameter indicates that numbers 1, 2, 3,6 and 9 are 
assigned to all WTO and WTOR messages that do not already have routing and 
descriptor codes. The HARDCPY parameter indicates that a device with address 
00E is used to record operator commands. The omission of the second positional 
parameter indicates that no write-to-operator messages are put on the hard- 
copy log. The third positional parameter in the HARDCPY parameter specifies 
that operator and system commands and responses are written on the hard-copy 
log. 

SCHEDULR TYPE=MVT,OPTIONS=LOG,WTOBFRS=80, 
REPLY=18,CONOPTS=MCS, 
CONSOLE= (I-00C,O-0 IB) , ALTCONS=00 A, 
ROUTCDE* (1,2, 4, 5, 9) ,OLDWTOR= (1 ,2,3,6,9) , 
HARDCPY=(00E,,CMDS) 
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SECMODS 

The SECMODS macro instruction specifies the type of system error recovery 
desired for each secondary CPU. This macro instruction is optional. 

Basic Requirements 

• OPTIONS=COMM must be specified in the SUPRVSOR macro instruction. 

• This macro instruction cannot be specified if TYPE=M65MP is specified in 
the CTRLPROG macro instruction, or if 85 or 195 is specified in the CENPROCS 
macro instruction. 

• S/360 Models 85, 91, or 195 can be used only as a primary CPU. 
Nucleus Generation 

• This macro instruction is used so that the new nucleus supports the same 
secondary CPUs as those supported by the primary nucleus. 

• The same parameters that were used during the last complete generation 
must be respecified without any changes. 

I/O Device Generation 

• This macro instruction must be specified if it was specified during the 
last complete generation. 

• The same keyword parameters and their subparameters that were used during 
the last complete generation must be respecified without any changes. 

• If this macro instruction was not specified during the last complete 
generation, it cannot be specified. 



Name Operation Operand 

SECMODS operand[ , operand ].. . 

Each operand must be written in the following format: 

model [ (SER-option) ] 

Uppercase letters, parentheses, and hyphens must be written exactly as shown. 

model 

specifies the model of the secondary CPU as one of the following: 40, 50, 
65, or 75 (for these models the primary CPU is S/360); ALL, 135, 145, 155, 
158, 165, or 168 (for these models, the primary CPU is S/370) . 
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Notes: 

• A maximum of five secondary CPUs can be specified. 

• ALL is specified alone to designate all S/370 CPUs other than the one 
specified in the CENPROCS macro. It can only be used with a S/370 
primary CPU. 

SIZE-storage 

Note: 

This operand is no longer necessary. If specified, it is ignored. 

option 

specifies the system error-recovery option as either SERO, SER1 , 
or MCH. 

Default: If this parameter is omitted, the value shown in Figure 85 is assumed 
for the secondary CPU model. 

Note: 

For S/370 CPUs only MCH may be specified. 

Coding Hints and Additional Information 

The following facts may be helpful. 

• A secondary CPU is one other than the primary CPU specified in the 
CENPROCS macro instruction on which the new system may run. 

• The system error-recovery options for the primary CPU are specified 
with the SER parameter of the SUPRVSOR macro instruction. 
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S/360 Models 








S/370 Models 






40 


50 65 


75 


135 


145 


155 158 


165 


168 


SERO 


SER1 SER1 


SER1 


MCH 


MCH 


MCH MCH 


MCH 


MCH 



Figure 85. SER Default Values for Secondary CPUs 

Example: This example illustrates the use of the SECMODS macro instruction to 
provide SER support for two secondary CPUs. The first operand defaults to 
SER1 for Model 50. The second operand specifies SER1 for Model 40. 



SECMODS 50,40(SER-SER1') 
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SECONSLE 

The SECONSLE macro instruction specifies a secondary console when the multiple 
console option (MCS) is specified in the CONOPTS keyword parameter of the 
SCHEDDLR macro instruction for the new system. This macro instruction is 
required when HCS is specified. 

Basic Requirements 

• The CONSOLE keyword parameter of this macro instruction must be used to 
specify the alternate console for the master console that is specified 
in the ALTCONS keyword parameter of the SCHEDULR macro instruction. 



A maximum of 31 secondary consoles can be specified, 
the system generation process is terminated. 



If more are coded. 



• Each device specified in an ALTCONS keyword parameter must also be specified 
in a CONSOLE keyword parameter of a SECONSLE macro instruction or the 
console parameter of the SCHEDOLR macro instruction. 

Nucleus Generation 

• This macro instruction must be specified if it was specified in the last 
complete operating system generation. The same keyword parameters and 
subparameters must be coded. 

• If this macro instruction was not used in the last complete operating 
system generation, it cannot be specified. 



I/O Device Generation 



This macro instruction must be specified if it was specified in the last 
complete operating system generation. 

This macro instruction can be used to add, delete, or change the secondary 
console specifications. 

If this macro instruction was not used in the last complete generation, 
it cannot be specified. 



Name Operation Operand 

SECONSLE CONSOLE^ t address 

-address C,USE= §pl 
C1SJ 
address, O-address)] 
'ALTCONS* ( address 

address 
address, O-address)^ 
r OPSTRAN*nn ] 
; PFK=nn ] 

ROOTCDE- i ALL Y\ 

\ (routing codef , routing code]... )jj 
'TALDCHD= (command code[ , command code]..,)] 
; AREA=(nn[,nn... ]) ] 



(add] 
0-a< 
(I-< 
* I addi 
{ 0-a< 
! (I-e 
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AREA= 

specifies the dimensions of the display areas to be set aside for status 
displays on the display console screen specified in the CONSOLE= operand. 

nn 

is a decimal number equal to the number of display screen lines to 
be in the display area. The minimum specification is four lines; 
the maximum specification is the number of lines in the message area 
of the defined display area. Each nn defines one display area of 
the size indicated. The first nn defines the bottom-most display 
area on the screen (the bottom lines of the message area) . Subsequent 
nn's define areas stacked above the bottom-most area working toward 
the top of the screen. 

Default: If this parameter is not specified when a display console is specified 
in the CONSOLE^ operand, the system defaults one display area for that console. 
The size of the display area depends on the type of console specified. Display 
area default sizes for the various types of display consoles are as follows: 

Console Number of Lines 

2250 14 

2260 8 

3277 Model 2 14 

Consoles for Models 85, 165, 

91, or 195 14 

Note: The AREA parameter reserves 36 bytes of storage space in the nucleus 
for each area defined. The areas defined here become the default during each 
IPt. Areas may also be added by the operator after IPL. Storage required 
for these additional areas (32 bytes per area) is obtained dynamically from 
the system gueue area (SQA) . The AREA parameter should be used to define the 
areas to be used in a normal case, not the possible maximum. 

ALTC0NS= 

specifies the address or addresses of the alternate console. 

address 

is the unit address of an alternate console device with input and 
output capabilities. 

O-address (only) 

is the unit address of a console with output capability. 

I-ad dress 

is the unit address of an input device of a composite console. 

O-address 

is the unit address of an output device of a composite console. 

Default: If this keyword parameter is omitted, the master console specified 
in the CONSOLE keyword parameter of the SCHEDOLR macro instruction is assigned 
as the alternate console. 
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Notes: 

• Required: The device specified must also be specified in the CONSOLE 
keyword parameter of either the SCHEDULE or a SECONSLE macro instruction. 

• Address: Each unit address used must be the same as that specified for 
the device in an IODEVICE macro instruction. For a list of the devices 
that can be used, see Figure 86. 

• Restriction: A console with only output capability cannot be specified 
as the alternate console for a console with input and output capabilities. 

• Composite Console: A device specified as a part of a composite console 
cannot be specified in any other way, that is, as a single device or as 

a part of a composite console with a different companion device. However, 
the same combination can be specified more than once. 

CONSOLE= 

specifies the address or addresses of the secondary console. 

address 

is the unit address of the secondary console device with input and 
output capabilities. 

O-address (alone) 

is the unit address of a console with output capability. 

I-address 

is the unit address of an input device of a composite console. 

O-address 

is the unit address of an output device of a composite console. 

USE= 

defines the intended use of a 2260 or 3277 and 3158 display (CRT) 
console. 

SD 

indicates that the specified console is to be used as an output-only 
console for status displays. 

indicates that the specified console is to be used as an output-only 
console to display operator messages. 

Default: If "O-address" is specified for a 2260 or 3277 display console, and 
the 0SE= parameter is omitted, the USE=SD parameter is assumed and the console 
is designated for status displays. If "address" is specified for a display 
console, and USE* is omitted, the console is designated as an input/output 
(full capability) console. 



MS 




Notes: 



Required: Each unit address used must be the same as that specified for 
the device in an IODEVICE macro instruction. For a list of the devices 
that can be used see Figure 86. 

Composite Console: A device specified as a part of a composite console 
cannot be specified in any other way, that is, as a single device or as 
a part of a composite console with a different companion device. However, 
the same combination can be specified more than once. 
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Output-only Display Consoles: A 2260 or 3277 display console without input 
capability should be designated as "O-address," and SD or MS according 
to its purpose. The 3277 Model 1 is used for MS only. A 2260 or 3277 
display console with input and output capability can be designated by 
either "address" or "O-address" and SD or MS; however, specifying 
"O-address" disables the console's input capability. If "address" and 
USE=SD or MS are specified for a 2260 or 3277 console with input and 
output capability, the console is initially placed in output-only mode. 
After IPL, the operator can alter the console for either input/output or 
output-only use. He can also respecify SD or MS. All display consoles, 
other than the 2260 or 3277, should be specified by "address," and the 
USE= parameter should be omitted. 

OPSTRAN= (For all types) 

specifies the transient display control module (OCM) group to which the 
display (CRT) console, specified in the CONSOLE= parameter, is assigned. 
OPSTRAN applies only to display consoles. 

nn 

is a decimal number from 1 to 32 selected by the user. 

Notes: 

• Required: Multiple Console Support (MCS) . 

• If the OPSTRAN=nn parameter is not specified, each Display Control Module 
(DCM) must be resident in main storage at all times. If the OPSTRAN=nn 
is specified, up to four consoles may be assigned to a transient group. 

Display Control Modules (DCMs) are control blocks that contain system 
information required for display (CRT) consoles. Each display console 
has its own DCM. For further information about DCMs, see OS MFT Supervisor 
Logic or OS MVT Supervisor Logic. 

• The use of transient DCMs can reduce resident storage requirements 
associated with display consoles. Any type of display console can operate 
from a transient area, but a master console, its alternate, and other high 
message consoles perform with greater speed if they are not assigned to 

a transient area. Transient DCMs work to greatest advantage for consoles 
with lower than average message activity. 

PFK= 

specifies that the console is to have programmed-function-keyboard (PFK) 
command entry and/or light pen command entry. 

nn 

is a decimal number from 1 to 12 indicating the number of PFK keys 
or key numbers to be associated with operator commands. 

Notes: 

• Required: Multiple Console Support (MCS) . 

• PFK command entry applies only to display (CRT) consoles. The specified 
console must have either a PFK or a light pen attached. The number 
indicated by nn specifies: 

the number of PFK keys that the operator can associate with commands after 
IPL, or 

the number of light-pen-detectable numerical indicators in the PFK line 
of the screen that the operator can associate with commands after IPL. 

If the specified console has both a PFK and a light pen, both methods of 
command entry will be made available when the PFK macro is specified. 
For further information about PFK and light pen command entry, refer to 
OS Operator 1 s Guide for Display Consoles. 
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ROUTCDE= 

specifies which routing codes the console receives. 

ALL 

specifies that all routing codes are desired. 

routing code 

a number from 1 to 16 that designates which routing code is recognized 
and accepted by this console. 

Default; If this keyword parameter is omitted, no routing codes are assigned 
to this console. 

Note: 

Information: For detailed information about the routing codes, see OS 
Supervisor Services and Macro Instructions. 

VALDCMD= 

specifies which commands can be entered from this console. 

command code 

is a number from 1 to 3. (0 is always assumed.) 

Notes: 

• Value: One or more numbers may be specified that indicate which command 
groups can be entered from this console. (For detail information about 
command code groups, see OS Operator "s Reference.) 

• Restriction: This parameter cannot be specified if the console only has 
output capability. 

• Use: The commands DISPLAY, LOG, REPLY, SHOW, BRDCST, and MSG can be used 
at all consoles with input capability. 

Although DISPLAY and MONITOR can be used at all consoles with input 
capability to terminate a display of STATUS, JOBNAMES, SPACE, DSNAME, or 
SESS with the STOP command, the command issuing the DISPLAY or MONITOR 
command must also have Group 1 command authority. 

Coding Hints and Additional Information 

The following example illustrates the use of the SECONSLE macro instruction 
to specify a secondary console whose address is 01F and whose alternate console 
is a composite console with addresses 00C and 00D. The secondary console can 
receive all routing codes as specified by the ROUTCDE parameter and can enter 
commands 1, 2, and 3 as specified by the VALDCMD parameter. The secondary 
console is a display console assigned to transient group number 05. The console 
includes a PFK. Support for command entry for 10 of its keys is reguested 
by means of the PFK* operand. 

SECONSLE CONSOLE=01F,ALTCONS=(I-00C,0-00D) , 

ROUTCDE=ALL , VALDCMD= (1,2,3), OPSTRAN=0 5 , PFK= 1 

The following example illustrates the use of the SECONSLE macro instruction 
to specify a secondary console with output-only capability. The address of 
the console is 00E, and the address of the alternate console is 00B (the 
alternate console also has output-only capability) . The secondary console 
is a display console. It is used to display system status displays, as 
specified by the USE- parameter. The console*s screen is divided into two 
display areas -the bottom-most area is seven lines long, and the top area is 
four lines long. These display area specifications are made by means of the 
AREA- parameter. 
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The console is assigned to transient group number 05, as specified by the 
OPSTRAN parameter. 



SECONSLE 



CONSOLE=O-00E,USE=SD, ALTCONS=O-00B, AREA= (7,U) , 
OPSTRAN=05 



Subparameter Unit Address of: 



Maximum Notes 
Number 



address 



1052 Model 7 



2250 



2260 

2740 

3066 

3158 
3210 

3215 

3277 
5450 



Model 1 with alphameric 
keyboard, character gen- 
erator and 4K or 8K buffer 

Model 3 with alphameric 
keyboard (Requires the 
GRAPHICS macro instruction 
and IODEVICE macro instruc- 
tion — NUMSECT parameter.) 

Model 1 Local attachment 
with alphameric keyboard 
with the 2848 Model 3 with 
the line-addressing feature 

Model 1 with record- 
checking feature or with 
optional-interrupt feature 



Same as 3277-2 



Model 2 with keyboard 
Console for Model 85 



31 



31 



31 



31 



31 
l 1 



Light pen is optional 



Light pen is optional 



Only one per com- 
munications line 



Can only be used with 
MCS for S/370 
Models 165 and 168 



Can only be used for 
S/370 Models 135, 145, 
155, and 158 

Can only be used for 
S/370 Models 135, 145, 
155, and 158 

Selector pen is optional 



O-address 
(only) 



1403 

1443 
2260 



3211 
3213 

3277 
3277 



31 



Model 1 Local attachment on 
a 2848 Model 3 with line- 
addressing feature (alphameric 
keyboard is not required) 



31 
31 



Model 1 
Model 2 



31 
31 



Maximum of 30 if all 
are O-address only 
consoles 



Can be used only for a 
S/370 Model 158 



Figure 86 (Part 1 of 3) . 



Devices for Which Unit Addresses can be Specified in 
CONSOLE and ALTCONS Parameters of SECONSLE 
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Subparameter Unit Address of: 

3284 Models 1 and 2 
3286 Models 1 and 2 



Maximum 
Number 

31 

31 



Notes 



I-address 
(composite) 



O-address 
(composite) 



1052 
1442 
2250 



Model 7 
Model N1 



31 
31 



2260 

2501 
2520 
2540 
2740 

3066 
3210 

3215 

3277 
3505 
3525 
5450 



Model 1 with alphameric 31 
keyboard, character generator, 
and 4K or 8K buffer 

Model 3 with alphameric 
keyboard (Requires the 
GRAPHICS macro instruction 
and IODEVICE macro instruc- 
tion — NOMSECT parameter.) 

Model 1 Local attachment with 31 
alphameric keyboard with the 
2848 Model 3 with the line- 
addressing feature 



31 



Reader 



31 
31 



Model 1 with record-checking 31 
feature or with optional- 
interrupt feature 



Model 2 with keyboard 

Card Reader 

Card Punch 

Console for Model 85 



31 
31 
31 
1i 



Light pen is optional 



Light pen is optional 



Only one per communications 
line 



Can only be used with MCS 
for S/370 Models 165 and 168 

Can only be used for 
S/370 Models 135, 145, 
155, and 158 

Can only be used for 
S/370 Models 135, 145, 
155, and 158 



Selector pen is optional 



Must have reader feature 




1052 
1403 

1443 



Model 7 



31 
31 

31 



Maximum of 30 if all are 
O-address only consoles 



Figure 86 (Part 2 of 3) , Devices for Which Onit Addresses Can Be Specified in 

CONSOLE and ALTCOVS Parameters of SECONSLE 
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Subparameter Unit 
3211 
2250 



Address of: 



Maximum Notes 
Number 



2260 

2740 

3066 

3210 

3213 
3215 

3277 
5450 



Model 1 with alphameric 
keyboard, character gen- 
erator, and 4K or 8K buffer 

Model 3 with alphameric 
keyboard (Requires the 
GRAPHICS macro instruction 
and IODEVICE macro instruc- 
tion — NOMSECT parameter.) 



Model 1 Local attachment with 31 
alphameric keyboard with the 
2 848 Model 3 with the line- 
addressing feature 

Model 1 with record-checking 31 
feature or with optional- 
interrupt feature 



31 Light pen is optional 



Light pen is optional 



Model 2 

Console for Model 85 



31 
1* 



Only one per communications 
line 



Can only be used with MCS 
for S/370 Models 165 and 
168 

Can only be used for 
S/370 Models 135, 145, 
155, and 158 

Can only be attached to 
a 3158 

Can only be used for 
S/370 Models 135, 145, 
155, and 158 



* Subtract 1 from maximum number if this device type was specified as a master 
console. 

Figure 86 (Part 3 of 3) . Devices for Which Unit Addresses Can Be Specified in 

CONSOLE and ALTCOHS Parameters of SECOHSLE 
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SORTLIB 

The SOBTLIB macro instruction specifies the inclusion of the sort/merge 
subroutine library (SYS1. SORTLIB) in the new operating system. This macro 
instruction is optional. 

Basic Requirements 

• SYS 1. SORTLIB must be allocated space in the new system. It may be cataloged 
in the new system during preparation for system generation. 

• The SORTMERG macro instruction must be specified. 
Processor/Library Generation 

The following condition must exist to replace an existing SYS 1. SORTLIB. 

• The existing SYS 1. SORTLIB must be scratched and uncataloged before the 
new SYS 1. SORTLIB is initialized during preparation for this generation. 
In order to regain the space that was occupied by the SYS 1. SORTLIB that 
was scratched, use the IEBCOPI utility program. 

Name Operation Operand 

SORTLIB [UNIT=name] 
[ VOLNO=serial ] 

Default; If the keyword parameters are omitted, the sort subroutine library 
is placed on the new system-residence volume. 

0NIT= 

specifies a direct-access device in the generating system that will contain 
the volume on which the sort subroutine library will be generated. 

name 

is the device type. 

Note: 

Required; If this keyword parameter is specified, VOLNO must be coded also. 

VOLNO= 

specifies the volume that is to contain the sort subroutine library. 

serial 

is the serial number. 




Notes: 



Required: If this keyword parameter is specified, UNIT also must be coded. 

Value: The value specified must be the same as the value given to the 
VOLUME keyword of the DD statement used to allocate space for SYS1. SORTLIB 
during preparation for system generation. 
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Coding Hints and Addition 

This example illustrates the use of the SORTLIB macro instruction to specify 
the inclusion of the sort subroutine library in the new operating system. 
The unit name is 2311. The volume serial number is 654321. 



SORTLIB 0NIT=2311,VOLNn=65U321 
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SORTMERG 

The SORTMERG macro instruction specifies the inclusion of all or selected 
sorting ana/or merging functions in the new operating system. This macro 
instruction is optional. 



Basic Requirements 



• The SORTLIB macro instruction must be specified. 

• If user-written exit routines that require link-editing at execution time 
are going to be included, the EDITOR macro instruction must be specified. 

• Any function that has not been specified in this macro instruction must 
not be coded in the sort/merge control cards at execution time. For 
example, if the sorting of only fixed-length records is specified during 
system generation, the sorting of variable-length records must not be 
requested at sort/merge execution time. The sort/merge job would be 
terminated because the programs for sorting variable-length records were 
not in the system. 

Processor/Library Generation 



• The SORTLIB macro instruction must be specified. 

• If user-written exit routines that require link-editing at execution time 
are going to be included, a linkage editor must be in the system. If the 
system already has a linkage editor, the EDITOR macro instruction does 
not have to be specified. 

• There must be enough space in SYS1.LINKLIB for the new sort/merge processor. 

If this macro instruction is being used to replace an existing sort/merge 
processor, then the following conditions must also exist: 

• Members IERRCB, IERRCM, IERRCZ, and IERRC000 (alias SORT) must be scratched 
from SYS1.LINKLIB. The space that was occupied by these members can be 
recovered by using the IEBCOPY utility program. 

• The existing SYS 1. SORTLIB must be scratched and uncataloged before 
initializing the new SYS 1. SORTLIB unless the INDEX keyword parameter is 
specified in the GENERATE macro instruction and the new SORTLIB is defined, 
with a user-supplied qualifier. 



SORTMERG 



Name Operation Operand 

SORTMERG lSIZE=size] 

CSORTOPT=FOLLIB] 
'CNTLFLD= ([ SINGLE ][ , MULTIPLE ]) 
RECTYPE=([VAR][ , FIXED ][ ,LONG]) 
SORTDEV* (device[ , device]...) 
^MERGE=MERGONLY] 

~*MESSAGE= ((PRINTER) /, ALL \1 

^CONSOLE/ \, CRITICAL [ J 

^SORTOPT-MODPRGM] 
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CNTLFLD= 

specifies the control field requirements for sorting and/or merging. 

SINGLE 

specifies single control fields. 

MULTIPLE 

specifies multiple control fields. 

Note: 

Required: One or both values must be coded. 

MERGE= 

specifies which routines of the sort/merge processor can be executed 
independently. 

MERGONLY 

specifies that the merge routines may be executed independently. 

Note: 

If this keyword parameter is omitted and FOLLIB is not specified for the SORTOPT 
parameter, then the merge routines cannot be executed independently. 

MESSAGE= 

specifies the I/O device on which sort/merge messages are to be printed 
and the type of messages to be produced. 

PRINTER 

specifies that the messages are to be printed on a printer. 

CONSOLE 

specifies that the messages are to be printed on a console. 

ALL 

specifies that all the messages are to be printed. 

CRITICAL 

specifies that only serious diagnostic messages are to be printed. 

Default: If this parameter is omitted, no messages are printed during a sorting 
or merging operation. 

Notes: 

• Required: The values included in braces are mutually exclusive. 

• Execution Time: This parameter can be changed at execution time. (See 
OS Sort/Herge for more information.) 

RECTYPE= 

specifies the type and length of records to be sorted or merged. 

VAR 

specifies variable-length records. 

FIXED 

specifies fixed- length records. 

LONG 

specifies records longer than 256 bytes. 
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Notes: 

• VAR or FIXED; It least one of these must be specified. You can specify 
both. 

• Spanned Records: If spanned records (VRE) are going to be sorted or merged, 
then VAR must be specified. 

SIZE= 

SIZE 

specifies as a positive decimal integer the amount of main storage 
to be used by sort/merge. If this parameter is omitted a value of 
12000 is assumed. The value assigned may be overridden at execution 
time by the CORE= parameter passed to the program. 

Default: If this keyword parameter is omitted, 12,000 is assumed. 



Notes: 



Use: The amount specified is used for sorting only and does not include 
the space required for the data management functions. 

Execution Time: The amount can be changed at execution time. For further 
information, see OS Sort/Merge. 

The sort/merge program can operate in 12,000 bytes for very short records, 
but a larger value is recommended for efficient execution. In any case 
where records over 50 bytes are to be sorted you should add at least 
whichever is the greater of 



Input BLKSIZE ♦ 4 x LRECL, 
and Output BLKSIZE ♦ M x LRECL, 

where M= (number of intermediate work areas to be used +1) /2 for tape sorts 
and M*=number of intermediate work areas to be used for disk sorts. 

A large storage size allows sort/merge to use more buffers and better 
sorting techniques, and to sort more records at a time in storage, thus 
greatly reducing the time taken for sorting. (For further information 
refer to OS Sort/Merge.) 

The maximum value that can be specified for size is the difference between 
the total amount of main storage available and the amount required for 
data management routines. 

Formula: Use the following formula to determine the value of SIZE: 

SIZE = A - 24N - Y - S - C 




is the total amount of main storage available for execution. The 
maximum amount is the number of bytes in the region or partition 
minus the number of bytes required for the nucleus minus, if 
sort/merge is called by another program, the number of bytes occupied 
by other programs. 

is the maximum number of DD statements to be used in any of the 
sort/merge programs. 

is a constant value of 1500 if any messages are to be written on 
SYSOOT. Otherwise, the value of Y is 0. 



System Generation Macro Instructions 437 



S is a constant with a value of 3500 if the merge-only function is not 
to be used. If the merge-only function is to be used, the value of 
S is 5000 when spanned records are not used, or 5500 when spanned 
records are used. 

C is the amount of main storage reguired by checkpoint/restart. To 

calculate this value, see OS Storage Estimates. If checkpoint/restart 
is not to be used, the value is 0. 

S0RTDEV= 

specifies the devices (s) used for sorting or merging. 

device 

is a value that can be 2301, 2311, 231 4, or 2400. 

Notes: 

• Device; The value 2400 stands for 2401, 2402, 2403, 2404, 2415, 2420, 
3410, and 3420. 

• Use: One or more values can be coded. 

SORTOPT= 

specifies the options that you can select. 

FULLIB 

specifies that all the sort/merge functions are to be included in 
the new operating system. 

MODPRGM 

specifies that user-written modification programs will be included 
at sort/merge execution time. 

Notes; 

• FPLLIB: If this subparameter is coded, then RECTYPE, SORTDEV, CNTLFLD, 
MERGE, MESSAGE, and SORTOPT=MODPRGM are ignored. 

• Assumes: This subparameter assumes CONSOLE and ALL for the MESSAGE 
parameter. 

Coding Hints and Additional Information 

The following guidelines can be useful. 

• The sort/merge program operates in 15,500 bytes of main storage, 12,000 
bytes of which are actually used for sorting. However the amount 12,000 
can be increased by specifying more than 12,000 in the SIZE parameter. 

• SORT0PT=F0LLIB assumes CONSOLE and ALL for the MESSAGE parameter. 

Example: The following example illustrates the use of the SORTMERG macro 
instruction to specify the use of fixed-length records, single control fields, 
and IBM 2311 Disk Storage Drives. The merge functions are to be included. 
The maximum amount of main storage to be used for sorting is 12,000 bytes. 



SORTMERG RECTYPE=FIXED,CNTLFLD=SINGLE,SORTDEV=23 1 1,MERGE=HERGONLY 
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SUPRVSOR 

The SOPRVSOR macro instruction specifies the task supervisor options. This 
macro instruction is optional for MFT. It is required for MVT or M65MP. 

Basic Requirements 

For assistance in choosinq valid task supervisor options for HFT, MVT, and 
H65MP, refer to Fiqure 88 in the "Codinq Hints and Additional Information" 
section at the end of this macro instruction description. 

Nucleus Generation 



• The values specified in the followinq keyword parameters can be chanqed 
durinq this qeneration. 

The operand for TRACE can be changed. 

For RESIDNT: Only the followinq keyword subparameters can be added to 
or deleted from the parameter statement: ACSMETH, RENTCODE, ERP, and 
TRSVC. 

For OPTIONS: Only the followinq keyword subparameters can be added to 
or deleted from the parameter statement: TRSVCTBL, PROTECT, VALIDCHK, 
and COMH. 

• All the other keyword parameters and their subparameters must be specified 
in exactly the same way as they were durinq the last complete operatinq 
system qeneration. 

Processor/Library Generation 

• This macro instruction must be specified if PL1LIB macro instruction is 
used. 

• All the keyword parameters and their subparameters must be specified in 
exactly the same way as they were durinq the last complete system 
qeneration. 

I/O Device Generation 

• This macro instruction must be specified with the same keyword parameters 
and subparameters that were specified durinq the last complete operatinq 
system qeneration. 

• If this macro instruction was not specified in the last complete operatinq 
system qeneration, it cannot be specified in this qeneration. 
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Name 



Operation 



SUPRVSOR 



Operand 



ASCII- 



{ EXCLUDE )"| 
INCRES > 
INCTRANjJ 



INCRES 

INCTRAN 

; RESIDNT=<function[ , function ]•-..) } 
" OPTIONS= (opt ion[ , option]. ..) ) 
: ALTSYS=ddd] 

{TIME )" 

INTERVAL} 
JOBSTEP } 
TRACE=number ] 

!SERG)' 
SER1> 
MCH ) 



ALTSYS= (For all control programs) 

specifies the alternate system- residence device to be used by the dynamic 
device reconfiguration (DDR) system residence support. 



ddd 



is the unit address of a device of the same type as the system- 
residence device. 



Note: 



Required: This keyword parameter must be specified if OPTIONS=DDRSYS is coded. 

ASCII= (For all control programs) 

specifies the inclusion or exclusion of the ASCII translate routine. 

EXCLUDE 

specifies that the routine will not be included in the system. 

INCRES 

specifies that the routine will be included in the SYS 1. NUCLEUS data 
set. 

INCTRAN 

specifies that the routine will be included in the SYS1.SVCLIB data 
set. 

Note: 

EXCLUDE is the default value for the ASCII parameter. 

OPTIONS= 

specifies task supervisor options as one or more of the following values. 
These values may be listed in any order. 

APR (For all control programs) 

specifies that alternate path retry (APR) will be included. 

Note: This subparameter does not have to be specified for the M65HP systems 
as it is automatically included. 

ATTACH (For HFT only) 

specifies that the ATTACH function with the subtasking capability 
is to be included in the new operating system. 

Note: This subparameter is required to support CRJE and integrated emulators*, 

Default: If this subparameter is omitted, the ATTACH function without 
the subtasking capability will be included in the new operating system. 
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CCH (For all control programs) 

specifies that the channel-check handler be included. 

Notes: 

• S/360 Models 65, M65MP, 75, or 91: CCH must be specified if this 
option is to be included. 

• S/360 Models 85 and 195 and S/370: CCH is automatically included. 

COMM (For all control programs) 

specifies that there will be communication with the operator at IPL 
time for the purpose of changing certain system generation options. 

Notes: 

• This option must be specified if a BLDL list for SYS1.SVCLIB is 
desired. 

• The subparameters BLDLTAB, ACSMETH, BENTCODE, ERP, and TRSVC can. be 
deleted or modified at IPL time only if the COMM option was included 
at system generation. 

• SCHEDOLR Macro Instruction: The value in any of the following keyword 
parameters can be changed at IPL time: INITQBF, JOBQFMT, JOBQLMT, 
JOBQRES, JOBQTMT, JOBQWTP, MINPART, PROCRES, STARTR, and STARTW. 

• CTRLPROG Macro Instruction: The value in the keyword parameter QSPACE 
can be changed at IPL time. 

• Required: This subparameter must be specified if telecommunication 
devices are specified for an M65MP system. 

• Information: The communications procedure is decribed in OS Operator 1 s 
Reference. 

DDR (For all control programs) 

specifies that dynamic device reconfiguration (DDR) will be included. 

Default: If this subparameter is omitted and DDRSYS and/or DDRNSL are 
specified, this option is assumed and included in the new system. 

Note: This subparameter does not have to be specified for M65MP systems 
because it is automatically included. 

DDRNSL (For all control programs) 

specifies that dynamic device reconfiguration for magnetic tape volumes 
with nonstandard labels will be included. 



Notes: 



This subparameter must be specified if there are nonstandard labels 
on any volumes in the system and DDR is desired. 

A nonstandard label routine must be supplied with the name NSLREPOS 
and placed in SYS1.M0DGEN before the system generation process is 
started. (See "Program Options Descriptions" for further information.) 
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DDRSYS (For all control programs) 

specifies that the dynamic device reconfiguration for system-residence 
volumes will be included. 

Note: If this subparameter is specified, then ALTSYS must also be 
specified. 

DECSIM (For MVT) 

specifies that a decimal simulator routine for the S/360 Model 91 
will be included. 

Notes; 

• Use: DECSIM should be specified if COBOL or PL/I is to be included 
in the system, or if decimal arithmetic instructions are to be used 
with the assembler language. 

• Restriction: This subparameter should not be specified for the S/360 
Model 195. 

IDENTIFY (For MFT) 

specifies that the IDENTIFY function is to be included. 

Notes: 

• Reguired: If IDENTIFY is specified as a value of the RESIDENT keyword 
parameter, it need not be specified as a value of this keyword 
parameter. 

• Emulator ; This subparameter is required if the EMULATOR macro 
instruction is specified. 

• HVT (including M65MP) : This subparameter does not have to be specified 
because it is assumed for MVT (including M65MP) systems. 

NODAV (For all control programs) 

specifies that the code will not be included to verify the volume 
serial number of any 2311 or 231ft volumes (mounted after IPL time) 
that have not been specified by a system mount reguest. 

Note: This subparameter is ignored if DDR f DDRSYS, or DDRNSL are specified. 
(The volume serial number verification is reguired when DDR is in the 
system.) 

ONLNTEST (For all control programs) 

specifies that the online test (OLTEP) system function will be 
included. This function allows the running of I/O device tests under 
the operating system as a job step. 

Notes: 

• Obtaining: The online tests are contained in their own data set, 
and must be obtained from the IBB Branch Office representative. 

• MFT: At least three buffers must be specified in the ITOBFRS parameter 
of the SCHEDULR macro instruction for online test. 

• TIMER=INTERVAL or JOBSTEP in the SUPRVSOR macro instruction must be 
specified. 

• Console Command: If you want to call OLTEP by a console command, 
the cataloged procedure OLTEP must be added to SYS1. PROCLIB. 
Additional space must be allocated in SYS1. PROCLIB during the 
preparation for system generation. (For detailed information, see 
OS OLTEP. ) 

• 2955 device for S/370 : If the device is specified, online test is forced. 
ftft2 OS System Generation 



PROTECT (For all control programs) 

specifies that the protect function routine will be included when 
the protect feature is part of the central processing unit. 

Notes: 

• MFT: PROTECT includes the VALIDCHK option. 

• MVT (including M65MP) : This value must be specified for MVT including 
M65MP systems. 

RDE (For all control programs) 

specifies the inclusion of the reliability data extractor in the new 
system. RDE measures the reliability of the new system. For further 
information, see OS RDE Guide. 

RER (For all control programs) 

specifies that the reduced error recovery procedure for magnetic tape 
will be used if requested with the OPTCD parameter of a DD statement 
of the DCB macro instruction. 

Default: If this subparameter is omitted, all requests for reduced error 
recovery will be ignored. 

Note: 

Use: Reduced error recovery is used only for special applications, as 
described in the OS MFT Guide or OS MVT Guide* 

TRSVCTBL (For HFT) 

specifies that a table containing the relative track addresses of 
all transient SVCs is to be stored in the resident portion of the 
control program. 

Note: 

• MVT (including M65MP) : This subparameter does not have to be specified 
because it is assumed for MVT (including M65MP) systems. 

VALIDCHK (For MFT) 

specifies that the WAIT, POST, and GETMAIN/FREEMAIN modules are to 
contain extra validity checking to determine whether addresses are 
located within proper boundaries. 

Note: 

Use: The validity checking for WAIT also checks for the number of events. 

Note: 

For MVT (including M65MP) : IDENTIFY TRSVCTBL are assumed and PROTECT must 
be specified. 



SUPRVSOR 
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RESIDNT= 

specifies that one or more of the following functions, normally executed 
from the transient area, are to be included in the resident portion of 
the control program. These values can be listed in any order. 

ACSMETH (For MFT) 

specifies that access method modules are to be loaded and made part 
of the nucleus at IPL time. 

Notes: 

• ABEND/ABDUMP: In MFT, the BSAM modules IGG019BA, IGG019BB, and the 
BSAM device-dependent EOB module* s are required to provide dumps of 
main storage during abnormal termination. These modules should be 
made resident using this subparameter, or by specifying the RAM= 
parameter at IPL time. This avoids bypassing the dump facility when 
there is insufficient space in the failing task partition where these 
modules must be loaded. 

• Checkpoint/Restart: This subparameter must be specified for MFT 
systems if this facility is going to be used. 

• MFT-MCS systems: If a card reader or a printer is specified as a 
console this subparameter must be specified. 

• SMF; BSAM modules (IGG019BA, IGG019BB) must be resident in MFT and 
MVT to use the SMF option. If SMF is recording on a direct access 
device, IGG019CD must also be resident; if on tape, IGG019CC and 
IGG019BD must be resident. 

• System Log: BSAM modules (IGG019BA, IGG019BB, IGG019CD) must be 
resident in MFT to use the log facility. To include them, this 
subparameter must be specified. 

ATTACH (For all control programs) 

specifies that the ATTACH function is to be included in the nucleus. 

Note: The type of ATTACH made resident in MFT depends upon the subparameter 
of OPTIONS=. 

BLDLTAB (For all control programs) 

specifies that the directory entries for selected SYS1.SVCLIB or 
SYS1.LINKLIB modules are to be made resident at IPL time. 

ERP (For all control programs) 

specifies that the RERP option may be used at IPL time (in response 
to message IEA101A) to make resident the ERP modules listed in 
module IEAI GEO or alternate module (s) IEAIGEXX. 

Note ; 

• For a list of common error recovery routines that are loaded with the 
device dependent routines and made resident, see the OS Storage Estimates 
manual . 

• For a list of common error recovery routines that may be made resident, 
see the OS Storage Estimates manual . Additional information is also 
available in the OS MFT Guide and the OS MVT Guide . 

EXTRACT (For all control programs) 

specifies that the EXTRACT function is to be included in the nucleus. 

IDENTIFY (For all control programs) 

specifies that the IDENTIFY function is to be included in the nucleus. 
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RENTCODE (For all control programs) 

specifies either of the following: 

MFT; Any reenterable load modules from SYS1.LINKLIB or the loader 
program modules can be made resident. 

MVT or H65MP: Any module in SYS 1.LINKLIB or SYS1.SVCLIB can be made 
resident at IPL time. This value must be specified if 
checkpoint/restart is to be used in an MVT (including M65MP) system. 

SPIE (For all control programs) 

specifies that the SPIE function is to be included in the nucleus. 

TRSVC (For all control programs) 

specifies types 3 and 4 SVC modules are to be loaded and made resident 
at IPL time. 

Note: OPTIONS-TRSVCTBL must be specified for MFT. 

Notes: 

• ATTACH, EXTRACT, IDENTIFY, and SPIE: These are assumed if TYPE=MVT 
(including M65MP) is specified in the CTRLPROG macro instruction. 

• Use: The use of the option listed above is discussed in the OS MFT Guide 
and OS MVT Guide. 

• Information: Some of the values specify functions that are to be made 

part of the nucleus during system generation; other values specify functions 
that are made resident at IPL time. 

SER= (For all control programs) 

specifies the type of system error recovery desired for the CPU model 
specified in the CENPROCS macro instruction. One of two levels of system 
environment recording (SERO or SER1) or machine-check handler (MCH) may 
be specified. 

Default: If this keyword parameter is omitted, SERO, SER1 , or MCH will 

be supplied based on the CPU model specified in CENPROCS macro instruction. 

Figure 87 shows which default will be used. 



Notes: 



Secondary CPUs: The nucleus generated may operate on a CPU other than 
that specified in the CENPROCS macro instruction. The SER option for each 
additional CPU must be specified with the SECMODS macro instruction. 

SYS1. ASRLIB: If MCH is specified and refreshability is to be supported, 
the system generation process allocates space to and catalogs the 
SYS 1. ASRLIB system data set on the new system-residence volume. 

Model 91 or 195: SER1 must be specified. 

Model 40, 50, or 75: Only SERO or SER1 can be specified. 

Model 65 With MFT or MVT: MCH can be specified and an F-design-level 
linkage editor must be specified. 

Model 65HP: MCH is assumed and an F-design-level linkage editor must be 
specified. 

Model 85 with MFT or MVT: All MCH modules on SYS1.SVCLIB must be link 
edited with the downward compatible (DC) attribute. 



SUPRVSOR 
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S/360 Model 85 and S/370 models with MFT or MVT: MCH is assumed. 
S/360 Models S/370 Models 

40 50 65 65MP 75 85 91 195 135 145 155 158 165 168 
SERO SER1 SER1 MCH SER1 MCH SER1 SER1 MCH MCH MCH MCH MCH MCH 

Figure 87. SER Defaults for CPUs 

TIMER= 

specifies the inclusion of the timer function when the timer feature is 
part of the central processing unit. 

TIME (For MFT) 

specifies the ability to request date plus time of day in various 
units of measurement. 

INTERVAL (For all control programs) 

provides the same functions as TIME, plus changing the time at 
midnight, and the ability to request, check, and cancel intervals 
of time. 

JOBSTEP (For all control programs) 

provides the same functions as INTERVAL, plus the timing of each job 
step and enforcement of job step time limits. 

Default: If this keyword parameter is omitted, only the date will be provided. 

Notes: 



• Time-stamping: If proper time-stamping is expected on console messages, 
this keyword parameter must be included. 

• SMF: If ACCTRTN-SMF or ESV=SMF is coded in the SCHEDULR macro instruction, 
TIMER=JOBSTEP must be specified. 

• OLTEP: If OPTIONS=ONLNTEST is specified, either INTERVAL or JOBSTEP must 
be specified. 

• Emulator: If the EMULATOR macro instruction is specified, TIMER=INTERVAL 
or JOBSTEP must be specified. 

TRACE=(For all control programs) 

specifies the inclusion of an optional trace table. 

number 

is the number of entries in the table. 

Note: 

Information: See the OS MFT Guide and OS MVT Guide for a description of the 
trace table. 
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Coding Hints and Additional Information 

Figure 88 shows the relationship between parameters in this macro instruction. 
Parameter Comment Parameter 

RESIDNT=IDENTIFY Don't need to code: OPTIONS=IDENTIFY 

RESIDNT=TRSVC Then must specify (if OPTIONS=TRSVCTBL 

MFT) : 

OPTIONS=COMM These can be changed BLDLTAB, ACSMETH, 

at IPL time: RENTCODE, TRSVC 

Examples: The following example illustrates the use of the SUPRVSOR macro 
instruction to specify task supervisor options for multiprogramming with a 
fixed number of tasks (MFT) . A table containing the relative track addresses 
of transient SVCs is to be stored in the resident portion of the control 
program. The IDENTIFY and the ATTACH functions are to be included in the 
resident portion of the control program. There are 100 entries in the trace 
table. 

SUPRVSOR OPTIONS=TRSVCTBL f RESIDNT= (IDENTIFY, ATTACH) ,TRACE=100 

The following example illustrates the use of the SUPRVSOR macro instruction 
to specify task supervisor options for multiprogramming with a variable number 
of tasks (MVT) . It is assumed that ATTACH, EXTRACT, IDENTIFY, and SPIE are 
to be made resident. Resident types 3 and 4 SVC routines are to be loaded 
and made resident at IPL time. The IDENTIFY function and a table of the 
relative track addresses of all transient SVCs are assumed. The protect 
function is reguired. The operator may change TRSVC, MINPART, INITQBF, and 
QSPACE, but not RENTCODE and BLDLTAB. Timing of each job step is selected. 
There are 150 entries in the trace table. SER1 is to be used. 

SUPRVSOR RESIDNT=TRSVC,TIMER=JOBSTEP,TRACE=150,SER=SER1, 

OPTIONS= (PROTECT,COMM) 



SUPRVSOR 
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Keyword 



Value 



MFT 



MVT 



M65MP 





ATTACH 


Optional 


Assumed 


Assumed 




EXTRACT 


Optional 


Assumed 


Assumed 




IDENTIFY 


Optional 


Assumed 


Assumed 


RESIDNT 


SPIE 


Optional 


Assumed 


Assumed 




BLDLTAB 


Optional 


Optional 


Optional 




ACSMETH 


Optional 1 


— 


— 




RENTCODE 


Optional 


Optional 1 


Optional 1 




TRSVC 


Optional 


Optional 


Optional 




ERP 


Optional 


Optional 


Optional 




ATTACH 


Optional 


Invalid 


Invalid 




IDENTIFY 


Optional 


Assumed 


Assumed 




TRSVCTBL 


Optional 2 


Assumed 


Assumed 




PROTECT 


Optional 


Required 


Required 


OPTIONS 


VALIDCHK 


Optional 


Invalid 


Invalid 




COMM 


Optional 


Optional 


Optional 




ONLNTEST 


Optional 


Optional 


Optional 




CCH 


Optional* 


Optional 7 


Required 




DECSIM 


Invalid 


optional 


Invalid 




RER 


Optional 


Optional 


Optional 




APR 


Optional 


Optional 


Assumed 




DDR 


Optional 


Optional 


Assumed 




DDRSYS 


Optional 


Optional 


Optional 




DDRNSL 


Optional 


Optional 


Optional 




NODAV 


Optional 


Optional 


Optional 




RDE 


Optional 8 


Optional 8 


Invalid 


ALTSYS 


Address 


Optional 


Optional 


Optional 




TIME 


Optional 


Invalid 


Invalid 


TIMER 


INTERVAL 


Optional 


Optional 5 


Optional 5 




JOBSTEP 


Optional* 


Optional 8 


Assumed 


TRACE 


Number 


Optional 


Optional 


Optional 




SERO 


Optional 


Optional 


Invalid 


SER 


SER1 


Optional 


Optional 


Invalid 




MCH 


Optional 3 


Optional 3 


Assumed 



Required if checkpoint/restart facility of Checkpoint/Restart is to be 

used. 

Required if TRSVC is specified in the RESIDNT keyword. 

This option is a standard feature of the S/360 Model 85 and S/370 Models. 

Required if job/step CPU timinq feature is desired. 

Either INTERVAL or JOBSTEP must be specified for MVT or M65MP. 

Must be specified if DDRSYS is coded in the OPTIONS keyword. 

This option is automatically included for S/360 Models 85 and 195 and S/370 

Models. 

This option is valid for S/360 Model 195 and certain S/370 CPUs only. 

See the OS RDE Guide for a complete explanation of RDE. 
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SVCLIB 

The SVCLIB macro instruction is used to add your transient routines, in load 
module form, to the SVC library (SYS1. SVCLIB) during system generation. This 
macro instruction is optional. 

Basic Requirements 

• The load modules to be included must be members of a partitioned data set. 
The data set must be cataloged as SYS 1. name in the generating system. 

• The number, type, and SVRB extended save area of each SVC routine to be 
added must be specified in the SVCTABLE macro instruction. 

Processor/Library Generation 

• Sufficient space for your routines must have been allocated in SYS1. SVCLIB. 

• The number, type, and SVRB extended save area of each transient SVC must 
ha?e been specified with the SVCTABLE macro instruction during the last 
complete operating system generation or nucleus generation. 

Name Operation Operand 

SVCLIB PDS=SYS1.name 

MEMBERS* (name[ ,name]. . .) 

PDS= 

SYS 1. name 

specifies the name of the partitioned data set that contains the 
routines to be added. 

Note: 

The value of name cannot exceed eight alphameric characters, the first of which 
must be alphabetic. 

MEMBERS* 

name 

is the name of the member to be added. The name of each transient 
SVC routine must be of the form: 

IGCssnnn 




ss 



nnn 



is the number of the load module minus 1. For example, the 
second load module has a value of 01. The value of ss is always 
00 for type 3 SVC routines. 

is an SVC number. It must be a signed decimal integer (such 
as 242=24B) if the routine is called directly by SVC. 
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Notes: 

• Nonstandard Label Routines: The names of nonstandard label routines must 
conform to the proper naming conventions described in the OS Tape Labels. 

• Maximum: A maximum of 255 characters may be used in an operand field of 
any macro instruction. 

• Pser-Written: User-written SVC routines are described in the OS MFT Guide 
and OS MVT Guide. 

Coding Hints and Additional Information 

The following example illustrates the use of the SVCLIB macro instruction to 
add the routines named IGC0025E, IGC0025D, IGC0025C, and IGC0025B to the SVC 
library. These routines are members of the SYS1.USERSVC partitioned data set, 
and are each called directly by an SVC. 



SVCLIB PDS=SYS1.USERSVC,MEMBERS=:(IGC0025E,IGC0025D,IGC0025C,!IGC0025B) 
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SVCTABLE 

The SVCTABLE macro instruction specifies the number, type, and SVRB extended 
save area of the user-written supervisor call (SVC) routines that are to be 
added to the new operating system. This macro instruction is optional. 

Basic Requirements 

• Type 1 and 2: For each type 1 or type 2 SVC, there should be a 
corresponding module specified in the RESMODS macro instruction: one module 
may contain more than one resident SVC routine. 

• Type 3: For each type 3 SVC, there. should be a corresponding module 
specified in the SVCLIB macro instruction: each module may contain only 
one transient SVC routine. 

• Type 4: For each type 4 SVC, there should be one corresponding module 
specified in the SVCLIB macro instruction for each load module of the SVC 
routine. 

• Information: For further information on user-written SVC routines, refer 
to the OS MFT Guide or OS MVT Guide. 

Nucleus Generation 

• There should be an entry for each type 1 or 2 SVC specified in the RESMODS 
macro instruction. 

• There should be an entry for each previously generated type 3 or 4 SVC 
(using the SVCLIB macro instruction) that is to be supported by the new 
nucleus. 

I/O Device Generation 

• If this macro instruction was specified in the last complete generation, 
it must be specified with the same operands. 

• If this macro instruction was not used in the last complete generation, 
it cannot be specified in this generation. 

Name Operation Operand 

SVCTABLE operand[ , operand ].. . — 



SVCTABLE 



Each operand must be written in the following format: 

SVC-nnn-Ta-Sb 

Uppercase letters and hyphens must be written exactly as shown. 

nnn 

specifies the SVC number as a decimal integer. 

Notes: 

• Numeric Assignment: You must assign unique numbers to your SVC routines, 
and should assign them in descending order starting with 255 and ending 
with 200 to avoid conflict with the numbers assigned to IBM-written SVC 
routines. 

• Maximum Value: The highest SVC number that may be assigned is 255. 
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a 

is 1, 2, 3, or 4. 

Note: 



Purpose: The number specifies the type of SVC. 

b 

is a decimal number that specifies the number of doublewords in the extended 
save area of the SVRB associated with the SVC routine 

Notes: 

• Purpose: The decimal number indicates the number of doublewords by which 
the SVRB is to be extended. 

• Required Values: A type 1 SVC must have a value of 0. Types 2, 3, and 
4 can have a value of from to 6. 

Coding Hints and Additional Information 

The following example illustrates the use of the SVCTABLE macro instruction 
to specify that four user-written SVCs are to be addad to the new operating 
system. 

SVCTABLE SVC-255-T4-S5,SVC-254-T2-S3,SVC-253-T3-S1,SVC-252-T1-S0 
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SYSUTILS 

The SISOTILS macro instruction specifies the amount of main storage available 
to all the system and data set utilities except IEBCOPY. This macro instruction 
is optional. 

Basic Requirements 

• System and data set utilities are generated with every operating system. 
They operate in 15K bytes of main storage unless this macro instruction 
is used to specify a larger amount. The IEBCOPY utility program requires 
30K, but the program will obtain the storage it needs. 

I/O Device Generation 

• If this macro instruction was specified in the last complete system 
generation, it must be specified with the same size in the I/O device 
generation. 

• If this macro instruction was not used in the last complete operating 
system generation, it cannot be specified. 

Name Operation Operand 

SYSUTILS [SIZE=size] 

[EXCLUDE= (FDU)] 

<f»— — ^.^— — i^i^^— — »— ^^— ■— ■»— —^^ . . i . iii — ^^— — ~— — — ^— — i — — ~ — — — — — ■»■ 
SIZE= 

specifies the amount of main storage, in bytes, available to the system 

and data set utilities. 

size 

is a decimal number of from 15360 to 999424, or it may be of the form 
nnnK, where nnn is an integer of from 15 to 976 and K represents 1024 
bytes. 

Default: If this keyword parameter is omitted, a value of 15360 is assumed. 

EXCLUDE=FDU 

specifies that the form description utilities (FDU) macro 
instructions are to be excluded from the new SYS1 .LINKLIB. 



Coding Hints and Additional Information 

The following example illustrates the use of the SYSUTILS macro instruction 
to specify that there are 44K bytes of main storage available to the system 
and data set utilities. 

SYSUTILS SIZE=44K 
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TELCMLIB 

The TELCMLIB macro instruction specifies the inclusion of the telecommunications 
subroutine library in the new operating system. This macro instruction is 
optional. 

Basic Requirement 

• SYS 1. TELCMLIB must have space allocated for it in the new system. It may 
be cataloged. 

• TSO: This macro must be specified if a TSO system is to be generated. 

Name Operation Operand 

TELCMLIB [UNIT=name 1 

LVOLNO-serialJ 

Default; If these keyword parameters are omitted, the telecommunications 
subroutine library is placed on the new system-residence volume. 

UNIT= 

specifies a direct-access device in the generating system that will contain 
the volume on which the telecommunications subroutine library will be 
generated. 

name 

is the device type. 

Note; 

If this keyword parameter is specified, VOLNO must be coded also. 

VOLNO= 

specifies the volume that is to contain the telecommunications subroutine 
library. 

serial 

is the serial number. 

Notes; 

• Value; The value specified must be the same as the value given to the 
VOLUME keyword parameter of the DD statement used to allocate space for 
SYS 1. TELCMLIB during preparation for system generation. 

• Required; If this keyword parameter is specified, UNIT must also be coded. 

Coding Hints and Additional Information 

This example illustrates the use of the TELCMLIB macro instruction to specify 
the inclusion of the telecommunications subroutine library in the new operating 
system. SYS 1. TELCMLIB is to reside on the new system-residence volume. 

TELCMLIB 
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TSOPTION 

The TSOPTION macro instruction specifies the inclusion of several time-sharing 
options in the new operating system. This macro is valid only in a complete 
operating system generation of a TSO system. 

Name Operation Operand 

TSOPTION [LOGTIME=time] 

[LOGLINE=integer] 
f BCLMT=integer] 



LOGTIHE= 

specifies the length of time, in seconds, you may wait without a 
terminal response during LOGON. 

time 

is an integer from 1 to 16,777,215 

Default: 30 seconds. 

LOGLINE= 

specifies the number of syntactically valid lines that may be entered 
before an attempt to LOGON is automatically canceled. 

integer 

is an integer from 1 to 32,760 

Default: 10 lines. 

BCLMT= 

specifies the number of 130-byte records that will be set aside for your 
broadcast messages in the SYS1.BRODCAST data set. 

integer 

is an integer from 1 to 1000. 

Default: 100 records. 

Coding Hints and Additional Information 

This example illustrates the use of the TSOPTION macro instruction to specify 
the time-sharing options. It permits up to 500 seconds to elapse before 
LOGON issues a message. The new system will allow ten lines to be entered, 
and 200 broadcast records, before a LOGON attempt is canceled. 

TSOPTION LOGTIME=500,BCLMT=200 
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UADS 

The UADS macro instruction specifies the inclusion of the TSO SYS LOADS data 
set in the new operating system. This macro instruction is valid only in a 
complete operating system or processor generation of a TSO system. 

Basic Requirement 

Space must be allocated for SYS LOADS. The data set may be cataloged in the 
new system. 

Processor/Library Generatio n 

This macro instruction can be used to add to or replace a SYS LOADS data set. 
If an existing data set is to be replaced, it must be scratched and uncataloged 
before the new one is added. 

Name Operation Operand 

UADS rONIT=name 

[_VOLNO=serial 



Default: If the UNIT and VOLNO keyword parameters are omitted, SYS LOADS is 
placed on the new system-residence volume. 

ONIT= 

specifies a direct-access device in the generating system. The volume 
on this device will contain the SYS LOADS data set. 

name 

is the device type. 

Note: 

Required: If this keyword parameter is specified, VOLNO must also be coded, 

VOLNO= 

specifies the volume that is to contain the SYS LOADS data set. 

serial 

is a serial number. 

Note: 

Required: If this keyword parameter is specified, ONIT must also be coded. 

Coding Hints and Additional Information 

This example illustrates the use of the OADS macro instruction to specify the 
inclusion of the TSO SYS1.0ADS data set in the new operating system. The unit 
name is 2301. The volume serial number is 10454. 



UADS ONIT=2301,VOLNO=M0454 
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ucs 

The DCS macro instruction specifies the IBM standard character set images for 
a printer with the universal character set (UCS) feature. This macro 
instruction is optional. 

Basic Requirements 

• This macro instruction can be specified only if UNIT=3211 or if 
FEATURE=UNVCHSET and ONIT=1403 have been specified in the IODEVICE macro 
instruction. 

• If the UCS macro instruction is omitted, IBM standard character set images 
are not included in the system. Therefore, if you have a printer with 
UCS, you must add your own character set images to the system as described 
in OS Data Management for System Programmers . 

I/O Device Generation 



• This macro instruction can be specified to add UCS support for the printer 
if it was not supplied in the last complete system generation. 

• It does not have to be respecified if it has already been specified in 
a previous generation. 

Name Operation Operand 

DCS ONIT= £1403} 

[3211} 
IMAGED (image[ , image ].. .) 
DEFAULT- (image[ , image. . .) ] 

IMAGE* 

specifies the IBM character set images to be included as one or more of 
the following values. These values may be listed in any order. 



Value 



1403 


3211 


AN 


All 


HN 


Hll 



Gil 



PCAN 

PCHN 

PN 

QNC 

QN 

RN 

TN 



Pll 



Til 



IBM Standard Character Set Image 



Arrangement A, standard EBCDIC CHARACTER SET, $* CHARACTERS 



Arrangement H, EBCDIC character set for FORTRAN and COBOL, 
48 characters 

ASCII character set 

Preferred character set, arrangement A 

Preferred character set, arrangement H 

PL/I character set 

PL/I preferred character set for commercial applications 

PL/I preferred character set for scientific applications 

Character set for commerical applications of FORTRAN and 
COBOL 

Text printing, scientific 120 graphics 
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SN Preferred character set for text printing 

XN High-speed alphameric character set for 1403 Model 2 

YN High-speed alphameric character set for 1403 Model 3 or N1 

DEFAULT= 

specifies the character set images to be used as default options when a 
job does not specify a character set image through its job control language 
statements. 

image 

The values are the same as for the IMAGE keyword. 

UNIT= 

specifies the printer to be used for character set images designated by 
the IMAGE parameter. 

Default; 1403 is assumed if this keyword parameter is omitted. 

Notes: 

• Required: Any value specified with the DEFAULT keyword parameter must 
also be specified with the IMAGE keyword. 

• Recommendation: It is recommended that all character set images that can 
produce valid results as default options be specified. 

• PCS Macro Use: The UCS macro can be used only once to include the 1403 
and once to include the 3211. 

Coding Hints and Additional Information 

The following example illustrates the use of the UCS macro instruction to 
specify that the character set images AN, PN, and TN are to be included in 
the new system. The images AN and PN are designated as default options. 

DCS IMAGE=(AN # PN,TN) ,DEFAULT= (AN,PN) ,ONIT=1403 
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UNITNAME 

The 0NITNAME macro instruction is used to name a group of I/O devices. This 
macro instruction is optional. 

Basic Requirements 

• This macro instruction is required to name each group of I/O devices in 
the system, except for device types. (See Appendix A.) 

• All ONITNAHE macro instructions having the same NAHE value must appear 
consecutively in the input stream. 

• If the IBM-supplied cataloged procedures in STS1.PR0CLIB are used, this 
macro instruction must be used to assign certain names to groups of I/O 
devices. These names will be used by the IBH-supplied cataloged procedures 
to specify the I/O devices required. The names required are: 

SYSSQ For magnetic tape and/or direct-access devices 

SYSDA For direct-access devices only 

SYSCP For card punch 

• The only combination of unlike device types permitted in a group is magnetic 
tape and direct-access devices. 

• A maximum of 50 uniquely named groups can be specified for a system. If 
more are required, see Appendix B for the procedure to follow. 

• A maximum of 255 addresses can appear in one group. 

• A maximum of 255 characters can be used in the operand of any macro 
instruction. If more addresses must be listed for a particular name, 
another UNITNAME macro instruction is coded using the same name. 



I/O Device Generation 

• This macro instruction may be used to name a new group of I/O devices or 
rename an existing group of devices. 

• If the group names are to remain the same, they must be respecified. 

Name Operation Operand 

ONITNAHE 0NIT= i (address[ [ , address ]•.•[# (address, n) ]...]) ) 

(( (address, n) ) ) 

NAHE-name 

NAME* 

specifies the name to be given to a group of I/O devices. 

name 

is a value from 1 to 8 characters. Each can be alphameric, national, 
or one of the two special characters, slash (/) and hyphen (-) . 
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ONIT= 

specifies a group of I/O devices that will be recognized by the name 
assigned. 

address 

is the unit address of an I/O device to be included in the group. 

Note: 

Required: When n is specified, this address oust be the lowest number 
of the seguential addresses being specified. 

n 

is the number of units and the total of sequential addresses to be 
assigned. The value can be a number from 1 to 255. 

Notes: 

• Same Addresses: The addresses used must be the same as those specified 
in the IODEVICE macro instruction for those devices. 

• Parentheses Required: If the form (address, n) is used as the only 
subparameter of the macro instruction, double parentheses must be used. 
For example, UNIT= ( (180,4) ) would create a group of four devices that have 
the addresses 180, 181, 182, and 183. 

• Unlike Device Types: The only combination of unlike device types permitted 
in a group is magnetic tape and direct access devices. 

Coding Hints and Additional Information 

2420 Magnetic Tape Drives: To select these drives specifically, establish 
them as a group by assigning a group name and specifying their unit addresses. 

Maximum Number of Devices Formula: The maximum number of devices that can 
be included in groups is determined by the following formula: 

510 - N « Maximum number of devices 

N is the number of uniquely named groups. The maximum value of N is 
50. 

For example, if there are 40 groups, a maximum of 470 devices can be distributed 
among those groups. 

SYSDA and SYSSQ: It is recommended that 2321 addresses not be included in 
these groups because some processors (COBOL E and sort/merge) do not support 
intermediate work data sets on 2321 volumes. 

It is recommended that a group named SYSOUT be defined for intermediate system 
output data sets. The devices in the SYSOUT group should be a subset of the 
devices in the SYSDA group. The group name SYSOUT should be defined as the 
default value in the reader cataloged procedure. 
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Examples 

The following example illustrates the use of the UNITNAHE macro instruction 
to assign the name TAPE to the devices located at 180, 181, 182, 183, 190, 
191, 290, and 390. 

UNITNAME NAME=TAPE,UNIT=( (180,4) ,290,390, (190,2)) 



The following example illustrates the use of the OHITNAME macro instruction 
to assign a specific unit name to an unsupported I/O device. The unsupported 
device is located at address 167 (specified as 0NIT=D0MHY, ADDRESS=167 with 
an IODEVICE macro instruction) . 

ONITNAME NAME=167,DNIT=167 
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Cross-References Between the System Generation MACRO Instructions 

Many of the keywords in the system generation macro instructions require 
keywords in other macro instructions to specify a particular function. The 
relationships between the keywords of the system generation macro instructions 
is shown in Figure 89. 

Dependencies between the keywords within a macro instruction are not shown 
because they are illustrated by the macro instruction format and, when 
necessary, by tables within each macro instruction description. 

Note; 

In the table below (All) has been used to indicate that the entire macro 
instruction (all the parameters) is affected by the macro instruction referred 
to. 



Macro Instruction Keyword 



Macro Instruction 
Referred to 



ALGOL 


(All) 


ALGLIB 
CENPROCS 


ASSEMBLR 


(All) 


CENPROCS 


CENPROCS 


INSTSET 


SUPRVSOR 




FEATURE 


SOPRVSOR 




MODEL 


SUPRVSOR 
EMULATOR 


CHECKER 


(All) 


SCHEDULR 




DESIGN 


FORTRAN 


CKPTREST 


(All) 


SUPRVSOR 




ELIGBLE 


PL1 


COBLIB 


(All) 


COBOL 




DESIGN 


CENPROCS 
GRPAHICS 


COBOL 


(All) 


CENPROCS 
COBLIB 




DESIGN 


CENPROCS 



Keyword 
Referred to 

(All) 

INSTSET 
MODEL 

MODEL 

OPTIONS 

OPTIONS 

OPTIONS 
(All) 

OPTIONS 

DESIGN 

RESIDNT 

(All) 

(All) 

MODEL 
GSP 

INSTSET 
(All) 

MODEL 



Figure 89 (Part 1 of 6) . Cross-References Between Macro Instructions 
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Macro Instruction Keyword 



Hacro Instruction 
Referred to 



CTRLPROG 


HIARCHY 


PARTITNS 




QSPACE 


SCHEDULR 
SUPRVSOR 




SYSQDE 


SCHEDULR 




TMSLICE 


PARTITNS 
SUPRVSOR 




TYPE 


CENPROCS 
EMULATOR 
PARTITNS 


DATAMGT 


ACSMETH 


PTPT.PPOn 
U X JtvLiJtr I\VJo 

SUPRVSOR 
TELCMLIB 
EMULATOR 


EDIT 


(All) 


CMDLIB 


EDITOR 


DESIGN 


SUPRVSOR 


EMULATOR 


(All) 


SCHEDULR 

SUPRVSOR 

CENPROCS 
CTRLPROG 

DATAMGT 


FORTLIB 


(All) 


GRAPHICS 




BOONDRY 


CENPROCS 




DESIGN 


CENPROCS 


FORTRAN 


(All) 


CENPROCS 




DESIGN 


CENPROCS 


GJOBCTL 


(All) 


CTRLPROG 




CLASS 


CTRLPROG 




DAPOOL 


UNITNAME 




REGION 


CTRLPROG 




TYPE 


DATAMGT 
PTOP 




ONITS 


IODEVICE 



Keyword 
Referred to 

(All) 

ACCTRTN 
OPTION 

ACCTRTN 
CONOPTS 

(All) 
OPTIONS 
TIMER 

INSTSET 

(All) 

TYPE 
TIMER 
(All) 
(All) 

(All) 

SER 

REPLY 

WTOBFRS 

TIMER 

OPTIONS 

MODEL 

TYPE 

ACSMETH 

GSP 

MODEL 

MODEL 

INSTSET 

MODEL 

TYPE 

TYPE 

(All) 

TYPE 

ACSMETH 
(All) 

UNIT 



Figure 89 (Part 2 of 6) . Cross-References Between Macro Instructions 
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Hacro Instruction Keyword 



GRAPHICS 



(All) 



Hacro Instruction 
Referred to 

FORTLIB 
COBLIB 
PL 1 LIB 



SECONSLE 



IOCONTRL 


(All) 


IODEVICE 




FEATURE 


IODEVICE 




UNIT 


IODEVICE 


IODEVICE 


(Ally 


IOCONTRL 
UNITNAME 




ADDRESS 


CHANNEL 




FEATURE 


CTRLPROG 




OPTCHAN 


CHANNEL 




UNIT 


CENPROCS 

SCHEDULR 
UNITNAHE 


LOADER 


(All) 


SUPRVSOR 


OUTPUT 


(All) 


CHDLIB 


PARTITHS 


(All) 


CTRLPROG 




SnnK 


SUPRVSOR 


PL1 


(All) 


CENPROCS 
CKPTREST 
PL1LIB 
SUPRVSOR 


PL1LIB 


(All) 

CONVS 
HODES 


PL1 

SUPRVSOR 

PL1 

SUPRVSOR 

PL1 


PROCLIB 


(All) 


GENERATE 
UNITNAHE 


PTOP 


(AH) 


IODEVICE 

DATAHGT 
TELCHLIB 



Keyword 
Referred to 

(All) 

(All) 

(All) 
ALTCONS 
CONSOLE 
ALTCONS 
CONSOLE 

(All) 

OPTCHAN 

OPTCHAN 

(All) 
(All) 

TYPE 

(All) 

HODEL 

CONOPTS 
(All) 

OPTIONS 
(All) 

TYPE 
HIARCHY 

OPTIONS 

INSTSET 
ELIGBLE 
(All) 
WAIT 

(All) 

(All) 
OPT 

OPTIONS 
OPT 

INDEX 
(All) 

UNIT 
ADAPTER 
ACSHETH 
(All) 



Figure 89 (Part 3 of 6) . Cross-References Between Hacro Instructions 
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Macro Instruction Keyword 



Macro Instruction 
Referred to 



RESMODS 


(All) 


SVCTABLE 


SCHEDOLR 


ACCTRTN 


SUPRVSOP 




ALTCOMS 


IODEVICE 




CONSOLE 


IODEVICE 




ESV 


SUPRVSOR 




HARDCPY 


IODEVICE 
SECONSLE 




INITQBF 


SUPRVSOR 




JOBQFMT 


SUPRVSOR 




JOBQLMT 


SUPRVSOR 




JOBQRES 


IODEVICE 
SUPRVSOR 




JOBQTMT 


SUPRVSOR 




JOBQWTP 


SUPRVSOR 




MINPART 


SUPRVSOR 




OPTIONS 


DATAMGT 
GENTSO 




PROCESS 


IODEVICE 
SUPRVSOR 




REPLY 


EMULATOR 
SUPRVSOR 




STARTER 


IODEVICE 




STARTW 


IODEVICE 




TYPE 


CTRLPROG 




WTOBFRS 


EMULATOR 
SUPRVSOR 


SECMODS 


(All) 


CENPROCS 
CTRLPROG 
SUPRVSOR 



Keyword 
Referred to 

(All) 

TIMER 

ADDRESS 

ADDRESS 

TIMER 

ADDRESS 
CONSOLE 

OPTIONS 

OPTIONS 

OPTIONS 

ADDRESS 
OPTIONS 

OPTIONS 

OPTIONS 

OPTIONS 

ACSMETH 
(All) 

ADDRESS 
OPTIONS 

(All) 
OPTIONS 

ADDRESS 

ADDRESS 

TYPE 

(All) 
OPTIONS 

MODEL 
TYPE 
OPTIONS 
SER 



Figure 89 (Part 4 of 6) • Cross-References Between Macro Instructions 
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Macro Instruction 



Macro Instruction 


Keyword 


Referred 


SECONSLE 


(All) 


CTRL PROG 
SCHEDOLR 




ALTCONS 


IODEVICE 
SCHEDULR 




CONSOLE 


IODEVICE 


SORTLIB 


(All) 


SORTMERG 


SORTMERG 


(All) 


EDITOR 
GENERATE 
GENTSO 
SORTLIB 


SUPRVSOR 


(All) 


PL1LIB 




OPTIONS 


CENPROCS 

COBOL 

CTRLPROG 

PL1 

RPG 
SCHEDOLR 



RESIDNT 



SER 



TIMER 



WAIT 



EMULATOR 

CTRLPROG 
IOCONTRL 
IODEVICE 

CENPROCS 
SECHODS 

EMULATOR 
SCHEDULR 

CTRLPROG 
IODEVICE 



Keyword 
Referred to 

TYPE 

ALTCONS 

CONOPTS 

ADDRESS 
CONSOLE 

ADDRESS 

(All) 

(All) 

INDEX 
INDEX 
(All) 

(All) 

MODEL 

(All) 

QSPACE 

TYPE 

(All) 

(All) 
INITQBP 
MINPART 
JOBQFMT 
JOBQLMT 
JOBQRES 
JOBQTMT 
JOBQITP 
PROCRES 
STARTR 
STARTW 
WTOBFRS 

(All) 

TYPE 

FEATURE 

FEATURE 

MODEL 
option 

(All) 
ACCTRTN 

TYPE 
UNIT 
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Macro Instruction Keyword 
SVCLIB (All) 

SVCTABLE (All) 



OCS 



UNITNAME 



(All) 



UNIT 



Macro Instruction 
Referred to 


Keyword 
Referred to 


SVCTABLE 




(All) 


RESMODS 
SVCLIB 




(All) 
(All) 


IODEVICE 




FEATURE 
UNIT 


IODEVICE 




ADDRESS 



Figure 89 (Part 6 of 6) . Cross- References Between Macro Instructions 
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Appendixes 



Each of the following is provided in an appendix: 

A list of device type names automatically provided. 

The additional preparation required if more than 96 I/O devices are to 
be specified during system generation 

The distribution methods. 

The messages produced during system generation. 

Descriptions of Functionally Equivalent I/O Devices 
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Appendix A: Device Types 



A device type is automatically assigned during system generation to each 
collection of devices for which a type of device is specified by the UNIT 
parameter of an IODEVICE macro instruction. The names and the devices to which 
they apply follow. 

Magnetic Tape Drives 

Device Type Description 



2400 

2400-1 
2400-2 
2400-3 
2400-4 

3400-2 
3400-3 
3400-4 
3400-5 

3400-6 



2400 9-track magnetic tape drive, which has either an 800 byte- 

per-inch (density) capability when the dual-density feature is 

not installed, or a 1600 byte-per-inch (density) capability when 

the dual-density feature is installed 

2400 magnetic tape drive with 7-track capability and without 

data conversion 

2400 magnetic tape drive with 7-track capability and data 

conversion 

2400, 2415, or 2420 9-track magnetic tape drive, which has only 

a 1600 byte-per-inch (density) capability 

2400 or 2415 9-track magnetic tape drive having an 800- and a 

1600 byte-per-inch (density) capability 

3410 or 3420 magnetic tape drive having 7-track capability and data 
conversion 

3410 or 3420 9-track magnetic tape drive having 1600 byte-per- 
inch (density) capability 

3410 or 3420 9-track magnetic tape drive having 800 byte-per- 
inch and 1600 byte-per-inch (density) capability 
inch and 1600 byte-per-inch (density) capability 
3420 9-track magnetic tape drive having 6250 byte-per-inch 
(density) capability 

3420 9-track magnetic tape drive having 1600 byte-per-inch 
and 6250 byte-per-inch (density) capability 



Direct-Access Devices 



Device Type Description 



2301 

2302 

2303 

2305-1 

2305-2 

2311 

2314 

2321 



2301 drum storage 

2302 disk storage drive 

2303 drum storage drive 

2305-1 fixed-head disk storage (Model 1) 
2305-2 fixed-head disk storage (Model 2) 
2311 disk storage drive 
2314 direct-access storage facility 
2321 data cell drive 



3330 



3330 disk storage drive 
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Unit Record Equipment 
Device Type Description 



1052 
1053 

1403 
1442 
1443 

2495 

2501 
2520 

2540 
2540-2 

2671 

3066 
3158 
3210 
3211 
3213 
3215 

3505 
3525 



1052 printer keyboard 

1053 Model 4 printer 

1403 printer or 1404 printer (continuous form only) 

1442 card read punch 

1443 printer 

tape cartridge reader 

2501 card deader 
2520 card read punch 

2540 card read punch (read feed) 
2540 card read punch (punch feed) 

2671 paper tape reader 

3066 console — S/370 Models 165, 168 

3158 integrated CRT operators console — S/370 Model 158 

3210 console printer keyboard 

3211 printer 

Console printer, output only — S/370 Model 158 
3215 console printer keyboard 

3505 card reader 

3525 card punch with read and print feature 



Graphics Devices 

Device Type Description 



2250-1 
2250-3 

2260-1 
2260-2 
2265 

2280 
2282 

3066 
3277 
3284 
3286 
5450 



2250 Model 1 display unit 
2250 Model 3 display unit 

2260 Model 1 display station (local attachment) 
2260 Model 2 display station (local attachment) 
2265 display station 

2280 film recorder 

2282 film recorder/scanner 

3066 integrated CHT operators console — S/370 Models 165, 168 

3277 model 1 or model 2 display station 

3284 model 1 or model 2 printer 

3286 model 1 or model 2 printer 

Model 85 integrated CRT operator* s console 
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Optical Character Readers 
Unit Name Device Type 

1285 optical reader 

1287 optical reader 

1288 optical reader 

Magnetic Character Readers 

Unit Name Device Type 

1275 1275 optical reader sorter (available through World Trade branch 

offices only) 

1 «l 19 1419 magnetic character reader 

Audio Responses 

Unit Name Device Type 

7770 7770 audio response unit 
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Appendix B: Supporting Additional I/O Devices 



If you want to increase the limits specified in the IOCONTRL, IODEVICE, and 
DNITNAME macro instructions, you must follow a special procedure. There are 
two levels of additional I/O device support. The system generation with 248 
devices can be performed only on a central processing unit that has at least 
128K of main storage with a generating system that contains the Release 18 
or later level of Assembler F, or the starter operating system must be used. 
The first limit allows a maximum of 248 I/O devices, 80 control units, and 
100 group names. (Ten group names are assigned to each 2321 for which an 
IODEVICE macro instruction has been written.) The second limit allows up to 
768 I/O devices, 255 control units, and 100 group names. The main storage 
requirement for the generating system must be more than 128K to generate a 
new system with 768 devices. 

Before executing the system generation process, you must: 

• Calculate the amount of storage required by the unit control blocks (UCB) 

• Calculate the number of devices that can be specified in groups 

• Redefine two members of SYS1.GENLIB before starting Stage I 

• Insert two control statements in the system generation input deck 

After system generation, you should reestablish the standard definitions. 

Note; In this procedure, it is assumed that SYS1.GENLIB resides on a 2311 
direct-access volume whose serial number is DLIB04. If SYS1.GENLIB resides 
on a different volume or device, the volume serial number and device type 
should be modified accordingly. All other parameters must be coded as shown. 



Calculating the Storage Required by Unit Control Blocks 

The size of a unit control block (UCB) varies with the type of device. For 
example, a UCB for a magnetic tape is 24 bytes long and the UCB for a 2311 
disk drive is 64 bytes long. In addition, 4 bytes are added to each UCB if 
TYPE=H65MP is specified in the CTRLPROG macro instruction. All UCBs in a 
system must reside in the first 32K bytes of fixed main storage along with 
all the request queue elements (RQEs) , the control program nucleus, and the 
machine logout and PSW area. (The RQEs are specified by the parameter HAXIO 
in the CTRLPROG macro instruction.) The system generation process will be 
halted if the 32K limit is exceeded or if more than 768* paths are specified. 
Both of the following formulas must be satisified in order not to exceed the 
limits . 

Formula 1 

TP ♦ UR ♦ DA + GR ♦ TA + OC < 768 

TP is the number of teleprocessing devices. 

UR is the number of unit-record devices. 

DA is the number of direct-access devices. 

GR is the number of graphic devices. 

TA is the number of magnetic tape drives. 

OC is the number of optional channels specified. 
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Formula 2 



(24+A+B+BB) (TP+UB) + (64+A) (DA) + (12+C) (RQE) + (40«-A) (GR) ♦ (52+A) (TA) 

< 32,768-D-E 



A 

B 

BB 

TP 

UR 

DA 

C 

RQE 



GR 
TA 

D 



is 4 for M65MP. 

is 4 for a printer with UCS buffer. 

is 4 for the devices 1285, 1287, 1288, and 2495. 

is the number of telecommunications lines. 

is the number of unit-record devices. 

is the number of direct-access devices. (A value of 3.4 is 

used for each 2321.) 

is 4 for MVT or M65MP. 

is the number of request queue elements. 

In addition, add 1 for the recovery management support (RHS) if 

it is in the system. 

Also, add 2 if the dynamic device reconfiguration (DDR) option 

is in the system. 

is the number of graphic devices. 

is the number of magnetic tape drives. 

384 for machine logout and PSW area for S/360 Models 40 to 

75, MFT, and MVT. 

512 for machine logout and PSW area for S/370. 

4096 for machine logout and PSW area for M65MP. 

1978 for machine logout and PSW area for S/360 Models 85 

and 91. 

2584 for machine logout and PSW area for S/360 Model 195. 

2000 for MFT nucleus resident below 4K. 

2400 for MFT nucleus resident below 4K with time-slicing 

option. 

168 for MVT nucleus resident below 4K. 

168 for M65MP nucleus resident between IOS and first 4K. 



Calculating the Number of Devices for Groups 

The total number of devices that can be included in groups is determined by 
either of the two formulas below. 

For up to 248 devices use: 

A=510-N 
For up to 768 devices use; 

A=1028-N 

A 

is the total number of devices. A device may belong to more 
than one group, but it must be counted as a separate device each 
time it is used. 

N 

is the number of uniquely named groups. The maximum number is 
100 in both formulas. 
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Redefining Tvo Members of SYS1.GENLIB 

Two members of SYS1.GENLIB, SGGBLPAK and either SGPAK248 or SGPAK768, must 

be redefined for either level of limitation before Stage I of system generation 

can be executed. These members can be redefined by using the IEHPROGM utility 

program. The two utility control statements required to allow up to 248 devices 

are: 



RENAME DSNAME=SYS1.GENLIB,VOL=231 1=DLIB04 ,MEMBER=SGGBLPAK, 
NEWNAME=SGPAK96 * MUST START THIS LINE COL 16 * 

RENAME DSNAME=SYS1.GENLIB,VOL=2311=DLIB04,MEMBER=SGPAK248, 
NEWNAME=SGGBLPAK * MUST START THIS LINE COL 16 * 



The two utility control statements required to allow up to 768 devices are: 



RENAME DSNAME=SYS1.GENLIB,VOL=2311=DLIB04,MEMBEK=SGGBLPAK, 
NEWNAME=SGPAK96 * MUST START THIS LINE COL 16 * 

RENAME DSNAME=SYS1.GENLIB,VOL=2311=DLIB04,MEMBER=SGPAK768, 
NEWNAME=SGGBLPAK * MUST START THIS LINE COL 16 * 



The following DD statement is required in the step where the redefining is 
done: 

//ddname DD DSNAME=SYSUGENLIB,DISP=OLD 

The two members are redefined during an execution of the IEHPROGM utility 
program using the utility control statements and the DD statement given above. 
(Detailed information about the IEHPROGM utility program can be found in OS 
Otilities. ) Because IEHPROGM is also used to initialize the new system data 
sets during preparation for system generation, the utility control statements 
and the DD statement for redefining the members of SYS1.GENLIB can be included 
during the initialization run instead of executing IEHPROGM as a separate job. 

Before executing Stage I of the system generation process, you must insert 
two additional control statements in the input deck. 

For the limit of up to 248 devices, the statements are: 

COPY SGGBLPAK 
SLIMIT(I) SETB 1 

For the limit of up to 768 devices, the statements are: 

COPY SGGBLPAK 
&LIMIT(3) SETB 1 

These statements must immediately follow the DD * or DD DATA statement and 
precede any system generation macro instructions. 
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Reestablishing the Standard Definitions 

After the system generation process is finished, you should reestablish the 
standard definitions by using the IEHPROGM utility program. 

The following two control statements are required if the limit selected was 
up to 248 devices: 

RENAME DSNAME=SYS1.GENLIB,VOL=2311=DLIB04, X 

MEMBER=SGGBLPAK,NEWNAME=SGPAK248 * START LINE COL 16 * 

RENAME DSNAME=SYS1.GENLIB,VOL=2311=DLIB04, X 

MEMBER=SGPAK96,NEWNAME=SGGBLPAK * START LINE COL 16 * 

The following two statements are required if the limit selected was up to 768 
devices: 

RENAME DSNAME=SYS1.GENLIB,VOL=2311=DLIB04, X 

MEMBES=SGGBLPAK,NEWNAME=SGPAK768 * START LINE COL 16 * 

RENAME DSNAME=SYS1.GENLIB,VOL=2311=DLIB04, X 

MEMBER=SGPAK96,NEWNAME=SGGBLPAK * START LINE COL 16 * 

The following DD statement is always required in the step where the redefining 
is done: 

//ddname DD DSNAME=SYS1 .GENLIB,DISP=OLD 
i 
128K Users 

If SGPAK768 is required for the Stage I assembly, the IPL procedure for the 
distributed MET starter system should be modified as follows: 

Reply YES to the CHANGE PARTITIONS message. 

Reply (R 00, « P0= (ABC, LAST) , END, LIST*) to the CONTINUE DEFINITION message. 

After a SET DATE command issue: 

MN JOBNAMES 
START DSO.P0,00E 
START RDR.S,00C 
START INIT.A22 

If 00E and 00C are not the addresses of the writer and reader, enter the correct 
addresses. 
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Appendix C: Distribution Methods 



The starter operating system package is provided by one of the following 
distribution methods: 

• Complete starter operating system package for the 2311 disk storage drive ; 
This package is distributed on five disk packs, or two tapes with 1600 
BPI, or three tapes with 800 BPI, for restoring to disk packs. The volume 
serial numbers of the disk packs are DLIB01 , DLIB02, DLIB03, DLIB04 and 
DLIB05. TSO and TCAM generations require one additional disk pack or tape. 
The volume serial number of the disk pack is DLIB06. 

• Complete starter operating system package for the 2314 direct access storage, 
facility : This package is distributed on one tape with 1600 BPI, or two 
tapes with 800 BPI, for restoring to two 2316 disk packs. The volume 
serial numbers of the disk packs are DLIB01 and DLIB02. 

• Complete starter operating system package for the 3330 direct access storage 
facility: This package is distributed on one tape with 1600 BPI, or two 
tapes with 800 BPI, for restoring to one 3336 disk pack. The volume serial 
number of the pack is DLIB01. 

The starter operating system package distributed on disk packs is operable 
(though a backup copy of it should be made) . It contains the starter operating 
system and the libraries as they are shown in Figures 90 and 91. (The data 
sets are not necessarily provided in the order shown.) 

The starter operating system package distributed on tape includes all of the 
contents of the disk packs. Because the tapes must be restored onto disk 
packs, two additional independent utility programs — IBCDASDI and IBCDMPES 
— are provided at the beginning of each tape for use in restoring the disk 
packs. In Figures 90 and 91, the tape layout is shown beside the corresponding 
disk pack. Only the libraries shown on the disk packs are restored from the 
tapes. The IBCDASDI and IBCDMPRS programs will always be at the beginning 
of the tapes, but the other data sets may not be in the order shown. The 2314 
and 3330 distribution are available only on tape, and must be restored to the 
disk pack from the tape. 
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2311 DISTRIBUTION PACKS 






DLIB01 


DLIB02 DLIB03 


DLIB04 


DLIB05 


DLIB06 


STARTER SYSTEM 


SYS1.MODGEN SYS 1. DN554 


SYS1.GENLIB 


SYS 1.AL531 


SYS 1.TSOGEN* 


SYS1.PARMLIB 


SYS 1.CI505 


SYS1.MACLIB 


SYS1. AS037 


SYS1.CI555* 


SYS1.PROCLIB 


SYS1.CI535 




SYS1.CB545 


SYS1.TSOMAC* 


SYS1.MODGEN2 


SYS1.CQ513 




SYS 1. COBLIB 


SYS1.DUADS* 


SYS1.ACDS 


SYS1.CQ519 




SYS 1.CO503 


SYS1.DHELP* 




SYS 1. DM508 




SYS1.ED521 


SYS1.DCMDLIB* 




SYS 1 . DM509 




SYS1.FORTLIB 


SYS1.CQ548* 




SYS1.DN527 




SYS1.FO500 


SYS1.TCAMMAC* 




SYS1.DN533 




SYS1.FO520 






SYS1.DN539 




SYS1.FO550 






SYS 1 . I0523 




SYS1.LD547 






SYS 1.10526 




SYS1. LM501 






SYS1.LM537 




SYS1.LM512 






SYS 1.LM542 




SYS 1. LM532 






SYS1.RC536 




SYS1.LM546 






SYS1.RC541 




SYS1.NL511 






SYS1.RC543 




SYS1.PL1LIB 






SYS 1. RC551 




SYS1.PL552 






SYS1.SM023 




SYS1.RG038 






SYS 1. UT506 




SYS1.SORTLIB 
SYS1.SAMPLIB 
SYS1.DN554A 






2314 DISTRIBUTION PACKS 








DLIB01 




DLIB02 






STARTER SYSTEM 


SYS1.FO500 


SYS 1.TSOGEN 






SYS1.CQ548 


SYS1.FO520 


SYS1.GENLIB 






SYS 1. CI 555 


SYS1.FO550 


SYS1.MODGEN 






SYS1.DUADS 


SYS 1. I0523 


SYS1.MODGEN2 






SYS1.DHELP 


SYS 1.10526 


SYS1.SAMPLIB 






SYS1.DCMDLIB 


SYS1.LD547 


SYS1.DN554A 






SYS 1. DN554 


SYS1. LM501 


SYS1.TCAMMAC 






SYS1. AL531 


SYS1.LM512 


SYS1.TSOMAC 






SYS1. AS037 


SYS 1 . LM532 


SYS1.MACLIB 






SYS1.CB545 


SYS1.LM537 








SYS 1. CI505 


SYS1.LM542 








SYS 1. CI 535 


SYS 1.LM546 








SYS 1. COBLIB 


SYS1.NL511 








SYS1.CO503 


SYS1.PL1LIB 








SYS1.CQ513 


SYS1.PL552 








SYS1.CQ519 


SYS 1 . RC536 








SYS 1. DM508 


SYS 1.RC541 








SYS 1. DM509 


SYS1.RC543 








SYS 1. DN527 


SYS1.RC551 








SYS1.DN533 


SYS1.RG038 








SYS1.DN539 


SYS1.SM023 








SYS1.ED521 


SYS 1.SORTLIB 








SYS1.FORTLIB 


SYS1.UT506 








SYS1.ACDS 


SYS1.PARMLIB 
SYS 1. PROCLIB 







Figure 90 (Part 1 of 3) . Arrangeaent of Data sets 
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COMPLETE 2311 PACKAGE - DISK DISTRIBUTION 



^«TER OPERATE 6 
SYSTEM^ 

g jg f. PROCU g 
SVS1. PARW^®. 




S YS1. MODGEN 




component 
libraries 




COMPONENT 
LIBRARIES 




■DLIB06 - Required if TSO is to be included in the new system. 



COMPLETE 2314 PACKAGE - DISK PACK CONTENTS AFTER RESTORING FROM TAPE 



DLIB01 

*^*re R opera^ G 

SYSTEM^--**' 
g VS 1. PROC^ > 
^£ VSl. parmu b^ 
COMPONENT 
LIBRARIES 

frs O and Non-TSO^ 
fV'S 1. duaos 





^V'SI.SAMPU ^ 

. £YS ltsoge ^. 

SVS1.DN564^ 
"MCJQDMP) 

j ^gl.MAClj^ 

^Sl.TCAMj^ . 
® y S,1.TSOMAC 



Figure 90 (Part 2 of 3) . Arrangement of Data Sets 
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Two tapes if 1600 BP I 



TAPE DISTRIBUTION FOR 2311 PACKAGE 

Three tapes if 800 BPI 



DASDI 

Dump/Restore 

T/M 

DLIB01 

Starter 

Operating 

System 

SYS1.MODGEN2 

SYS1.PROCLIB 

SYS1.PARMLIB 

Trailer Record 

T/M 

DLIB02 

SYS1.MODGEN 

Trailer Record 

T/M 

DLIB03 

Component Libraries 

Trailer Record 

T/M 

DLIB04 

SYS1.GENLIB 

SYS1.MACLIB 

Trailer Record 

T/M 

Trailer Label 

T/M 



DASDI 

Dump/Restore 

T/M 

DLIB05 

Component Libraries 

SYS1.SAMPLIB 

SYS 1. DN554A 

(Service Aids) 

Trailer Record 

T/M 

DLIB06 

SYS1.TCAMMAC 

All TSO 

Libraries 

All TCAM 

Libraries 

Trailer Record 

T/M 

Trailer Label 

T/M 



DASDI 

Dump/Restore 

T/M 

DLIB01 

Starter 

Operating 

System 

SYS1MODGEN2 

SYS1.PROCLIB 

SYS1.PARMLIB 

Trailer Record 

T/M 

DLIB02 

SYS1.MODGEN 

Trailer Record 

T/M 

DLIB03 

Component Libraries 

(First Half) 

Trailer Record 

T/M 

Trailer Label 

T/M 



DASDI 




DASDI 


Dump/Restore 




Dump/Restore 


T/M 




T/M 


DLIB03 




DLIB05 


Dmponent Libraries 




Component Libraries 


(Second Half) 




SYS1.SAMPLIB 
SYS1.DN554A 


Trailer Record 




(Service Aids) 


T/M 






DLIB04 




Trailer Record 


SYS 1.GENLIB 




T/M 


SYS1. MACLIB 




DLIB06 
SYS1.TCAMMAC 


Trailer Record 




All TSO 


T/M 




Libraries 


Trailer Record 




All TCAM 


T/M 




Libraries 




Trailer Record 




T/M 




Trailer Label 






T/M 



DASDI 

Dump/ Restore 

T/M 

DLIB01 

Starter 

Operating 

System 

SYS 1. MACLIB 

SYS1.PROCLIB 

SYS1.PARMLIB 

SYS 1.TCAMMAC 

SYS 1 . TSOM AC 

Component Libraries 

Trailer Record 

T/M 

DLIB02 

SYS 1. GEN LIB 

SYS 1.MODGEN 

SYS1.MODGEN2 

SYS 1. SAMP LIB 

SYS 1.TSOGEN 

SYS1.DN554A 

(Service Aids) 

Trailer Record 

T/M 

Trailer Label 

T/M 



TAPE DISTRIBUTION FOR 2314 PACKAGE 
Two tapes if 1600 BPI. 

Two tapes if 800 BPI 



DASDI 

Dump/Restore 

T/M 

DLIB01 

Starter 

Operating 

System 

SYS 1. MACLIB 

SYS 1. PROCLIB 

SYS 1.PARMLIB 

SYS 1 . TCAMMAC 

SYS 1. TSOM AC 

Component Libraries 

(First Half) 

Trailer Record 

T/M 

Trailer Label 

T/M 



DASDI 

Dump/Restore 

T/M 

DLIB01 

Component Libraries 

(Second Half) 

Trailer Record 

T/M 

DLIB02 

SYS 1. GEN LIB 

SYS1.MODGEN 

SYS1.MODGEN2 

SYS 1.SAMPLIB 

SYS1.TSOGEN 

SYS 1.DN554A 

(Service Aids) 

Trailer Record 

T/M 
Trailer Label 
T/M 



Pigure 90 (Part 3 of 3) . Arrangement of Data Sets 
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3330 DISTRIBUTION PACKS 



DLIB01 



STARTER SYSTEM 


SYS1.FO500 


SYS1. 


TSOGEN 


SYS 1.TCAMMAC 


SYS1.FO520 


SYS1. 


GENLIB 


SYS 1.TSOMAC 


SYS 1 . FO550 


SYS1. 


MODGEN 


SYS 1 . CQ548 


SYS 1.10523 


SYS1. 


MOOGEN2 


SYS 1.CI555 


SYS 1.10526 


SYS1. 


SAMPLIB 


SYS1.DUADS 


SYS1. LD547 


SYS1. 


DN554A 


SYS 1.DHELP 


SYS 1. LM501 


SYS1 


.ACDS 


SYS 1.DCMDLIB 


SYS1. LM512 






SYS 1 . DN554 


SYS T. LM532 






SYS 1. AL531 


SYS1. LM537 






SYS1. AS037 


SYS1.LM542 






SYS 1.CB545 


SYS 1. LM546 






SYS 1. CI505 


SYS1.NL511 






SYS 1. CI 535 


SYS 1.PL1LIB 






SYS 1.C0BLIB 


SYS1.PL552 






SYS 1 . CO503 


SYS 1.RC536 






SYS 1.CQ513 


SYS 1.RC541 






SYS 1.CQ519 


SYS 1 . RC543 






SYS 1. DM508 


SYS 1.RC551 






SYS 1. DM509 


SYS 1.RG038 






SYS 1.DN527 


SYS 1.SM023 






SYS 1.DN533 


SYS 1.S0RTLIB 






SYS 1.DN539 


SYS 1. UT506 






SYS1.ED521 


SYS 1.PARMLIB 






SYS1. FORTLIB 


SYS 1.PR0CLIB 






SYS 1.MACLIB 









Figure 91 (Part 1 of 2) . Arrangement of Data Sets for the 3330 
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COMPLETE 3330 PACKAGE - DISK PACK CONTENTS AFTER RESTORING FROM TAPE 




.Sj jSl.TSOMAC ^ 

COMPONENT 
LIBRARIES 

' rs OandNon-TSO> 
SVsi. duads 




DASDI 

Dump/Restore 

T/M 

DLIB01 

Starter 

Operating 

System 

SYS 1. MAC LIB 

SYS 1.PROCLIB 

SYS 1.PARMLIB 

SYS 1.TCAMMAC 

SYS 1 . TSOM AC 

Component Libraries 

SYS 1. GEN LIB 

SYS 1.MODGEN 

SYS1.MODGEN2 

SYS 1.SAMPLIB 

SYS 1.TSOGEN 

SYS 1 . DN554A 

(Service Aids) 

T/M 
Trailer Record 

T/M 

Trailer Label 

T/M 



TAPE DISTRIBUTION FOR 3330 PACKAGE 
One tape if 1600 BPI. 

Two tapes if 800 BPI 



DASDI 

Dump/Restore 

T/M 

DLIB01 

Starter 

Operating 

System 

SYS 1. MAC LIB 

SYS 1.PROCLIB 

SYS 1. PAR M LIB 

SYS1.TCAMMAC 

SYS 1.TSOMAC 

Component Libraries 

(First Half) 

T/M 

Trailer Record 

T/M 

Trailer Label 

T/M 



DASDI 

Dump/Restore 

T/M 

DLIB01 

Component Libraries 

(Second Half) 

SYS 1. GEN LIB 

SYS1.MODGEN 

SYS1.MODGEN2 

SYS1.SAMPLIB 

SYS1.TSOGEN 

SYS 1.DN554A 

(Service Aids) 

T/M 
Trailer Record 

T/M 
Trailer Label 
T/M 



Figure 91 (Part 2 of 2) . Arrangement of Data Sets for the 3330 
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Appendix D: System Generation Messages 



System generation messages are produced by the assembler program during the 
expansion of system generation macro instructions. These messages are printed 
in the assembler listing in the SISPRINT data set. Two types of messages are 
produced: error messages and informative messages. 



ERROR MESSAGES 

Figure 92 shows the message code and format of system generation error messages. 
The messages follow. 

lEIaaannn text 

Explanation: The error indicated by the message text is a coding error 

in the system generation macro instruction, aaa. The message serial number, 

nnn, identifies the message. 

For the CHANNEL, IOCONTRL, and IODEVICE macro instructions, the message 
text begins with either the name field of the macro instruction or, if 
the name field was omitted, the seguential identification number provided 
by the system. 

Examples of these messages are: 

5# * * * IEICEN104 INSTSET VALUE NOT SPECIFIED 

5,* * * IEICHA102 CHANNEL2-ADDRESS VALUE NOT SPECIFIED 

5,* * * IEICHA102 CHAN#2-ADDRESS VALUE NOT SPECIFIED 

The first example illustrates a message for the CENPROCS macro instruction. 

The second example illustrates a message for a CHANNEL macro instruction. 
,, CHANNEL2 ,, is the name field of the macro instruction. The third example 
illustrates the same message, but in this case the name field of the macro 
instruction was omitted and ' , CHAN#2 ,, was supplied by the macro instruction. 

System Action: The assembler program did not produce a job stream in the 
SYSPUNCH data set. The program analyzed all remaining system generation? 
macro instructions and printed any other reguired messages. Either messages 
IEIGEN113 or IEIGEN116 was printed, followed by the message: GENERATION 
TERHINATED. Then the system generation process was abnormally terminated. 

Severity Code: 5 

User Response: Correct the error or errors indicated and begin the system 
generation process from the start of Stage I. 

IEIGEN113 QUIT SWITCH ON BEFORE GENERATE HACRO 

Explanation: One or more errors, indicated by messages, were detected 
before the GENERATE macro instruction was expanded. 

Severity Code: 7 
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IEIGEN116 QUIT SWITCH SET IN GENERATE MACRO 

Explanation: One or more errors were detected during expansion of the 
GENERATE macro instruction. 

Severity Code: 7 

7,* * * GENERATION TERMINATED * * * 

Explanation; The system generation process was abnormally terminated. 

Severity Code: 7 

WARNING MESSAGES 

Figure 92 shows the message code and format of system generation warning 
messages. The messages follow, 

IEIaaannn text 

Explanation: The message text indicates a machine condition that may cause 
errors in the new system. For example: 

0,* * * IEII0C114 PREVIOUS CONTROL UNIT HAS NO DEVICES 

System Action: The job stream is produced. 

Severity Code: 

User Response: If necessary, correct the condition indicated and begin 
the system generation process from the start of Stage I. 

INFORMATIVE MESSAGES 

*, message text 

Explanation: This type of message documents the options selected for the 
new system through the system generation macro instructions. All options 
are described, whether the selection was explicit or implicit. 

*** ma cro name***component name***component ID*** 

Explanation: This type of message will appear preceding any PUNCH statements 
that were produced by the macro expansion. 

macro name 

name of the macro instruction that produced any succeeding PUNCH 
statements. 

component name 

name of the component group responsible for maintaining the particular 
macro expansion. 

component ID 

is the identification to be used in reporting trouble if a problem 
is isolated to the code produced by the particular macro expansion. 
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Message 
Code 



Code 



I EI 



S,* 



* * IEIaaannn text 
s = Severity code: 

Warning mesf.age; the condition indicated may cause errors in new system. 
5 Error message; error in coding of a system generation macro instruction. 
7 Error message; message is produced by GENERATE macro instruction, 
aaa = Indication of system generation macro instruction at which error was 
detected; 

Macro Instruction 



aaa Macro Instruction 

AGL ALGLIB 

ALG ALGOL 

ASM ASSEMBLR 

CEN CENPROCS 

CHA CHANNEL 

CKP CKPTREST 

CKR CHECKER 

CMD CMDLIB 

COB COBOL 

COL COBLIB 

CTR CTRLPROG 

DAT DATAMGT 

EDI EDIT 

EDT EDITOR 

EMU EMULATOR 

FOL FORTLIB 

FTC FORTRAN 

GEN GENERATE or GENTSO 

GJC GJOBCTL 

GPH GRAPHICS 

HEL HELP 

IMG IMAGELIB 

IOC IOCONTRL 

IOD IODEVICE 

LDR LOADER 

LNK LINKLIB 

nn = Message serial number 
text = Message text 



aaa 
MAL 
OUT 
PLL 
PL1 
POP 
PRL 
PRM 
PTM 
RES 
RPG 
SCN 
SEC 
SCH 
SOL 
SOR 
SUP 
SVC 
SVL 
SYS 
TEL 
TSO 
UAD 
UCS 
UNI 



MACLIB 

OUTPUT 

PL1LIB 

PL1 

PTOP 

PROCLIB 

PARMLIB 

PARTITNS 

RESMODS 

RPG 

SECONSLE 

SECMODS 

SCHEDULR 

SORTLIB 

SORTMERG 

SUPRVSOR 

SVCTABLE 

SVCLIB 

SYSUTILS 

TELCMLIB 

TSOPTION 

UADS 

UCS 

UNITNAME 



Figure 92. System Generation Error and Warning Messages 
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Appendix E: Functionally Equivalent I/O Devices 



I/O Device Equivalent to Usage 

2319 2314 The 2319 is a three drive disk storage unit that 

attaches to any S/360 or 370. The 2319 drives 
are functionally equivalent to the 2314 drives. 
As vith the 2314, a maximum of eight drives can 
be used. 

When specifying a 2319, FEATURE^ in the IODEVICE 
macro can be used for all models except the 145. 
To specify a 2319, see the IODEVICE macro. 

2596 1442 The 2596 card read punch is functionally equivalent 

to the 1442 N1 card read punch. If the 2596 is 
specified as a 1442 N1 at system generation time, 
it becomes directly accessible by an assembler 
language program which enables it to read and 
punch 96-column cards. For information on the 
data management macros used to access a 2596, 
see OS Data Hanaaement Services Guide. 

Use: 

• The device may only be used for direct input 
from or direct output to an assembler language 
program. 

• The device may not be assigned as a job 
stream (STSIN/STSOUT) device. 

• A data set on the device may not be opened 
as both an input and output data set at the 
same time. 

• If both the 2596 and 1442 devices are being 
used in the same system, the device address 
cannot be included in a device class at 
system generation. 

• If both" the 2596 and the 1442 are being used 
in the same system, they must be assigned 

by their respective device addresses. 

• If, the system contains DDB, the 2596 cannot 
be replaced with the 1442 by the SWAP command. 

3333 3330 The 3333 is a two drive disk storage unit that 

attaches to any S/360 or 370. The 3333 drives 
are functionally equivalent to the 3330 drives. 
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Appendix F: Diagnostic Override 



Diagnostic override enables a job stream to be produced during Stage I, even 
though errors were found in the Stage I input deck.. The job stream that is 
produced may or may not be meaningful, depending on the type of error. 

If you want diagnostic override , include the following statements in the 
Stage I input deck after the Stage I job control language statements: 

COPY SGGBLPAK 
&SGMENTBC16) SETB 1 
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Indexes to Systems Reference Library publications are consolidated in 
OS Master Index for System Reference Manuals, GC28-6644. For additional 
information about any subject listed below, refer to other publications 
listed for the same subject in the Master Index. 



ABEND 

by utility data sets 79 

dump data set 217 

standard system codes 261 

(see also SYS 1. DUMP) 
Access method 

generation of 281,282 

graphics programming services 325-326 

optional 282 

resident 439-440 

(see also BDAM, ISAM, BTAM, QTAM) 
Accounting routine 2 4,98 

example 33,116 

to include 402 
Additional pairs of transient areas 

description 157 

specifying 276 
ALGLIB macro instruction 247 

cross-reference table 467 

specifying 245,246 

type of (table) 244 
ALGOL compiler 

component name 204 

generation of 247,248 

member names 247 

sample program 98 

to be included 204 
ALGOL library 

contains 211 

component name 204 

to be included' 211,245 

(see also SYS1. ALGLIB) 
ALGOL macro instruction 247,248 

cross-reference table 467 

specifying 247-249 

type of (table) 244 
ALGOL sample program 98 
Allocating space 

(see space allocation) 
Alternative channel addressing 

specifying 346-347 
Alternate console 

description 163,164 

specifying 397-401,403,425-430 
Alternate path retry (APR) 

description 157,158 

specifying 440 
American National Standard COBOL 

component name 204,215 

sample program 99 

specifying 267-274 

type of (table) 244 



(see also COBOL macro instruction) 
American National Standard COBOL library 
component name 204,215 
to be included 265-266 

(see also SYS1.COBLIB, COBLIB macro 
instruction, COBOL subroutines) 
APR 

(see alternate path retry) 
ASMBLR 

contained in 220 

during Stage I 79,80 

during Stage II 65,69,71,74-75 

restart 84,86 

user-written load module 2 4 

(see also assembly steps, Stage II, 
restart procedures ) 
ASCII 440 
Assembler language processor 166,167 

alias 220 

component names 204 

contained in 221 

decimal instructions 442 

during Stage I 79,80 

during Stage II 65,69,71,74-75 

F-design level 32,204,252 

generation of 251 

sample program 100 

sample steps, Stage II 69-70,74,76 

system generation requirements 33,34 

uses SYS1.MACLIB 224 

uses utility data sets 28-31,32-33 

(see also ASSEMBLR macro instruction) 
Assembler ^sample program 100 
ASSEMBLR macro instruction 

specifying 251 

type of (table) 244 

(see also assembler language processor) 
Assembly steps 

during Stage I 69,75,76 

during Stage II 14,65,69,74 

restart Stage I 79 

restart Stage II 80,81 

(see also ASMBLR) 
Asynchronous overlay 278 
ATTACH function 158-159 

description 1 59 

made resident description 158-159 

specifying 440,444 
ATTACH macro instruction 

(see SYS1 .LINKLIB) 
Automatic restart 261 
Automatic volume recognition 413,414 
Auxiliary storage 10 
AVR 413,414 
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Background jobs 320,321,322 
Backup copy 40,42 

disk 52-55 

examples 129 

tape 42,4 8 
Basic direct access method 

(see BDAM) 
Basic indexed sequential access method 

(see BISAM, ISAM) 
BDAM 

component name 20 4 

description of option 160,161 

to be included 2 82 
BISAM 2 82 

(see also ISAM) 
BLDL list 227 
BLDL table made resident option 

description 160,161 

specifying 441 
BSC1 telecommunications line 

description 340 

specifying 338,343,344,351,352 
BSC2 telecommunications line 

description 339,3 40 

specifying 338,343,344,351,352 
BSC3 telecommunications line 

description 339,341 

specifying 338,343,344,351,352 
BTAM 

component name 204 

option description 186,187 

required 322 

specifying 281,361,362 
Buffers 

COBOL 269 

FORTRAN 303-304 

linkage editor 293-29 4 

sections in 2840 346 

write-to- log (WTL) 413-414 

write- to-operator (WTO) 413-414 
Burst devices 

use of on channels 257,337,338 

list of 337 



Cards 

restarting from 81,82 

sample programs 9 8 
Catalog 10 

during restart 9 4 

examples 10-15,126-127,130,132,140,145 

listing 69,71,74,75 

user-written routines 449,450 

(see also system catalog, cataloged 
procedures ) 
Cataloged procedures 

for FORTRAN 295,301 

for MVT or M65MP 251,267,291,301 

group names for 39,463-465 

IBM supplied 229 



statements 1 1 

user-written 229 

(see also SYS1 .PROCLIB) 
Cataloged procedures library 

(see SYS 1 .PROCLIB) 
CATLG STATEMENT 

during initialization 8,11-15,31 

during reallocation 90,91,92,93-94 
CENPROCS macro instruction 

cross-reference table 468 

specifying 253-255 

type of (table) 244 
Central processing unit 302,421-423,446 

for starter system 34-35 

specifying 253-256 
Channel 

(see selector channel, multiplexor 
channel) 
CHANNEL macro instruction 

specifying 257-258 

type of (table) 244 
Channel programs 277 
Channel-check handler 161,440 
Character set 

for ALGOL 248,249 

for COBOL 267 

for FORTRAN 30 4 

for PL/I 371 

for starter operating system 3 4 

for 1403 343,344 

for 1443 343,344 

images 461,462 

UCS macro instruction 461-462 
CHECKER macro instruction 

cross-reference table 467 

specifying 260 

type of (table) 244 
Checkpoint/restart 

cataloged procedure (IEFREINT) 163 

description 162-163 

specifying 261,443-445 
CIRB macro instruction 

requirements 160,175,186,281 
CKPTREST macro instruction 371 

cross-reference table 467,469 

specifying 261-262 

type of (table) 2 44 
CMDLIB macro instruction 

cross-reference table 46 8,469 

specifying 263 

type of (table) 244 

(see also time sharing option) 
COBLIB macro instruction 32 5,326 

cross-reference table 467 

specifying 265-266 

type of (table) 2 44 
COBOL compiler 

component names 20 4 

E-design level 20 4 

generation of 267-274 
sample display 110 
sample program 109 

in new system 20 4 

sample programs 98,101 
COBOL E sample program 101 
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COBOL library 203 

(see also SYS1.COBLIB, COBLIB macro 
instruction, COBOL subroutines) 
COBOL macro instruction 265-266 

cross-reference table 467 

specifying 267-268 

type of (table) 2 44 
COBOL subroutines 

(see SYS 1. COBLIB) 
COBOL, American National Standard 

(see American National Standard COBOL) 
Coding conventions 1 57 

for macro instructions 239-240 
Command code groups 165 
Complete operating system generation 

description 1-3 

definition 1-3 

examples 3,123-130,136-148,149-153 

macro instructions 239-472 

preparations 7-59 
Component libraries 204-206 

catalog 26-30 

description 203 

example 130,132 

mounting 1 5 

in starter operating system 204-206 
Components 

list of 204-205 

(see also component libraries) 
Composite console 

description 163-164 

specifying 398-401,403-404,425 
Configuration 

(see machine configuration) 
Console 418-419,429-430 

alternate 163-164,397,425-426 

composite 163-164,398-401 ,403, 405, 
419-420 

examples 419-420,429-430 

master 165-166 

multiple consoles option 1,164-167, 
398-401,402,425 

primary 164 

secondary 425-426 

specifying 397-401 ,403-405, 425-426 
Contiguous data sets 

with reallocating 92-9 4 
Contiguous partitions 279 
Control program 

component name 204 

in complete generation 2 

in nucleus generation 2,275 

resident portion 444-445 

(see also SYS1 .NUCLEUS) 

starter operating system 30,34-35 

to be included 275-280 

type of 2 

(see also MPT, MVT, PCP, Model 65 
multiprocessing) 
Control unit 

specifying 331-336 

generating additional 476-480 

1051 334 

2403 334,343,344,345,346,350 



2404 


334,337,350 


2415 


334,350 


2701 


335,341 ,345 


2702 


335,341,345,353 


2703 


335,341,345,353 


2803 


333-336,347 


2804 


333-336 


2820 


333-336 


2821 


333-336 


2822 


333-336 


2840 


333-336,346 


2841 


333-336,347 


2848 


333-336,343 


3272 


333,334,336 


3803 


333,336 


3811 


333 



Conversational remote job entry (CRJE) 

Core image dump 217 

CPU 

(see central processing unit) 
CRJE 168-169 
Cross-references' in macro instructions 

244,467-472 
CTLG 2311 

description 35 

included in 35 

use of 29-30 
CTLG 2314 

description 35 

included in 3 5 

use of 29-30 
CTRLPROG macro instruction 

cross-reference table 468 

specifying 275-280 

type of (table) 2 44 
Current date 1 
CVOL parameter 

examples 1 4 



168-169 



13 



Data conversion 

feature 333-336 

sample program 103 
Data management routines 

included in 232 

macro instruction 281-282 

primary, component name 204 

(see also SYS1.SVCLIB, access methods) 
DATAMGT macro instruction 

cross-reference table 

specifying 281-282 

type of (table) 244 
Data sets 197 
Data set protection 10 
Data set utilities 

component name 20 4 
Data transmission 

processor to processor 

sample program 103 
DCB macro instruction 443 



468 



391 
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DCB parameter 20 8 

DD statement, initialization 10 

new system data sets 207 
DCMLIB 2 83 
DDR 

(see dynamic device reallocation) 
DD statement 

DUMMY 3 1 6 

example user-written module 2 4 

format, initialization 10 

for IEBPTPCH 81 

for IEHLIST 27,28,86 

for IEHPROGM 32 

for punching job stream 81 

for reallocating 88,94 

for restarting Stage I 80 

for SYS1.LOGREC 86 

for utility data sets 20-22,30 

input deck, initialization 8,9,10 

input deck organization 20-22 

sample programs 11-15 

sample of Stage II 69-71,75-76 
Decimal simulation for Model 91 

description 170 

specifying 253,254,442 
Descriptor codes 165-167 
Device type 

for cataloged procedures 1 1 

for initializing 9,10 

generating additional 475-481 

in macro instructions 245,266,298, 
313-315,3 89,43 3,455,463-465 

use of 337 
Diagnostic override 495 
Direct access 

control units 333-336 

I/O device 337-353 

examples of allocation 15-20 

examples of initializing 12-13 

initializing generating system 7-8 

initializing new system 8 

mounting requirements 15-16,28 

sample sort/merge program 117 

unit names 463-464 
Direct access volume serial number 

description 170 

specifying 442 
Direct system output facility (DSO) 

use of 25 
DISP parameter 

DD statement, initialization 8 
Display control module library 

description of 216 

specifying of 283 
Distribution libraries 32 
DRISAMP 

(see IEHDASDR sample program) 
DSNAME parameter 

DD statement initialization 9,10 

CATLG statement initialization 1 1 
DSO 

(see direct system output facility) 
DUMP , core image 

(see core image dump) 



Dynamic device reallocation (DDR) 
description 171,172 
specifying 441 



EDIT macro instruction 

cross-reference table 468 

specifying 285-289 

type of (table) 2 44 
EDITOR macro instruction 435 

cross-reference table 468 

specifying 291-292 

type of (table) 244 
Emulator 

for 709/7090/7094/709411 294 

specifying 293 

where to find information 29 4 
EMULATOR macro instruction 412 

cross-reference table 46 8 

specifying 293-294 

type of (table) 2 44 
Enqueue/dequeue function 444 
Error messages 

diagnostic, PL/I 374-376,377-378 

during Stage I 1,22,65,79 

for COBOL 2 71 

for FORTRAN 298 

for linkage editor 313,314 

(see also messages) 
Error override 495 
Error recovery routines 

included in 232 

reduced procedure 443 

RERP list 444 

system 444 

(see also SYS1.SVCLIB) 
Error routines, I/O device 343 
Examples 

adding CSECT to nucleus 24 

ASMBLR 20-21,127-12 8,131,132,141-144 

backup of new system 43-44,53-55, 
56-57 

complete generation 3,123-131 

creating restore tapes 129 

deleting utility data sets 129 

IBCDASDI 8,136,137,144 

IBCDMPRS 136 

IEBEDIT 81-84 

IEBPTPCH 81-82,137 

IEHDASDR 8,129,137 

IEHLIST 137 

IEHPROGM 11-15,69,76,79-80,88-94, 
126-127,129,140-141 

initializing new system data set 10-13, 
139 

initializing new system volumes 138,139 

initializing starter system 136-137 

initializing system residence volume 
137,139,144 

I/O device generation 144-147 

machine configuration 124,134 
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Examples (continued) 

MPT 133-148 

MVT 149-153 

nucleus generation 131-132 

obtaining generating system data 
sets 130 

of data set allocation 15-19 

of system generation 123-153 

processor/library generation 130-131 

punching job stream 81-82 

reallocation on same space 90-92 

reallocation with more space 91-94 

restart Stage I 79 

restarting with job stream on tape 82-83 

Stage I input deck 20,127,132,141-144 

steps in job stream 69-70,76,77 

user-written load module 2 4 
EXEC statement 

during reallocation 88-9 4 

during Stage I 65,71 

during Stage II 65,71 

restart assembly 84-86 

sample program use 100,103,108,109, 
112,118-126 
Expiration date 1 
Exponentiation 267,268 
EXTRACT function 4 45 
EXTRACT function made resident 

description 173 

specifying 445 



FORTRAN macro instruction 259 
cross-reference table 468 
specifying 301-305 
type of (table) 2 44 

Four-drive generation 17,19 



Fetch 

(see program fetch) 
Floating point 267,268 
Foreground jobs 320,321,322 
FORTLIB macro instruction 325-326,391,392 
cross-reference table 468 
specifying 295-300 
type of (table) 2 44 
FORTRAN compiler 

component names 20 4 

error message facility 298 

G-design level 204,295,301-305 

generation of 301-305 

graphic subroutine package 300 

sample display 

sample program 10 8-110 

H-design level 204,295,301-305 

sample programs 104 

syntax checker 

component name 20 4 
specifying 259-260 
use of 170,259,305,378-379 
(see also SYS 1 .FORTLIB, FORTRAN macro 
instruction, FORTLIB macro 
instruction, FORTRAN library, FORTRAN 
subprograms, graphic subroutines 
package) 



GENERATE macro instruction 10,65,68,69, 
389,435 

exception 244 

specifying 307-316 

type of (table) 244 

use of for MVT 2 5 

utility data sets 21-22 
Generating operating system 

data sets required 197 

space allocation for utility data 
sets 14-16 
Generation library 

(see SYS1.GENLIB, SYS1.MODGEN) 
GENTSO macro instruction 

cross-reference table 471 

specifying 317 

type of (table) 244 
GENTYPE PARAMETER (GENERATE) 244 
GETMAIN/FREEMAIN modules 444 
GJOBCTL macro instruction 319,325,326 

cross-reference table 468 

specifying 319-323 

type of (table) 244 
GJP 

(see graphic job processor) 
Graphic job processor 

component name 204 

to be included 319,322 
Graphic programming services 

component name 20 5 

description 173-175 

specifying 173 

to be excluded 326,362 

to be included 325 
Graphic subroutine package 

component name 20 5 

to be included 325 

sample programs for FORTRAN IV, COBOL, 
PL/I 108-110 
Graphic 2250 sample program 105-107 
Graphic 2 260 sample program 105-107 
GRAPHICS macro instruction 265,266,300,319,351 

cross-reference table 469 

specifying 325,326 

type of (table) 2 44 
Group name 

definition 242 

UNITNAME macro instruction 463-465 
GSP 

(see graphic subroutine package) 
GSP SAMP 

(see graphic subroutine sample program) 
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Hard copy log 

description 165 

devices can be used 419,420 

specifying 399-402,405-406,419,420 
HELP macro instruction 

specifying 32 7 

type of (table) 244 
Hierarchy 

(see storage hierarchies, main-storage 
hierarchy support) 
High speed multiplexor channel 257 



IBCDASDI utility program 136,137,139,144 

example of use 

included in 33 

used for initialization 7-8 

use of 43,53,56-57 
IBCDMPRS utility program 

included in 33,483 

obtaining 

use of 43,48,54,483 
IBCRVRP utility program 

included 33 
IDENTIFY function 44 2 
IDENTIFY function made resident 

description 174, '75 

specifying 442 
IEAIPL00 program 7-8 

included in 7,33 

(see also IPL) 
IEBCOPY utility program 

during Stage II 68,71 

performance considerations 206 

required 220 

restarting 84-86 

storage requirements 453 

use of 14-15,65,84,85,88,92,361,362 
IEBEDIT utility program 

use of 84 

use restart Stage II 82 
IEBPTPCH utility program 

use during- restart 82 

use of 45,48,52,81 ,82 
IEBUPDAT utility program 23,222 
IEBUPDTE utility program 23,220 
IEFREINT 

(see checkpoint/restart facility) 
IEHDASDPv sample program 111 
IEHDASDR utility program 

used for initialization 7-8 

use of 45 
IEHICSUP step 

restarting 86 

sample step 65,7 3 



IEKIOSUP utility program 65,71 

included in 220 

requirements 86,88,220 

restart 86,38 

use of 68,71 
IEHLIST utility program 

example of listing data sets 137 

included in 220 

restarting 86 

use of 20,46,55,59,65,71 
IEHPROGM utility program 

during Stage II 65,71 

example of initializing 126-127,132, 
142-144 

example of scratching data sets 130 

included in 2 20 

restarting 36 

used for initialization 3 

used to catalog 9 

use of 9,69,75,79,80,86,480-481 

use tc reallocate 119 
IEJESP 

(see FORTRAN E sample program) 
IEMSP2 

(see PL/I sample program) 
IEPSAMP 

(see COBOL E sample program) 
IERSP 

(see sort/merge sample program) 
IEUESP 

(see assembler sample program) 
IEWO 84 

steps 65,71 

use of 2 4,25,63 

(see also link edit steps) 
IEXSAMP 

(see ALGOL sample program) 
IEYSP 

(see FORTRAN G and H sample program) 
IFCDIP00 program 

included in 220 

restarting 86 

sample step Stage II 68,74 
IFCEREP0 (EREP) program 

included in 2 20 
IHGSAMP 

(see update analysis program) 
IKDSAMPL sample program 

(see data transmission, data 
conversion) 
IMAGELIB 2 44,327 
Independent utility programs 

included in 33 

punching 40 

use of 7-8 
INDEX keyword parameter (GENERATE macro 
instruction) 

example 31 

uss of 30-31 
Initialization 

description 7-14 

examples, input decks 8-14 

new system volumes 7-8 

Of SYS 1 . LOGREC 9 
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JOB statement 






for Stage II 312 






Job- s t ep t irci ng 






description 176 






specifying 446 






Job stream 






data, about 21-22 






description 65-76 






during restart 79- 


■94 




generation of 1-2, 


,20- 


■22 



Initialization (continued) purpose 20 

system data sets 8,9,10 sample 12-15,20-21 

(see also examples) use of 8,9-11,100 

Initial program loader (see IPL) JOB card 

Initiator 412 restart assembly 84,85 

Input deck RESTART parameter 261 

CATLG statements, initialization 10,11 use of, restart 81 

DD statements, initialization 10-11 user created for Stage II 309-310 

errors 79 Job control language (see JCJ.) 

example cf backup 129 Job scheduler 

example of cataloging 126-127 options 397-420 

example of generation 126-129,141-144,147-149 (see also SYS1 .SYSJOBQE, SCHEDULR macro 

example of initializing 126-127,132,140-141 instruction) 

example of scratching data sets 130 

for generation 20-22 

for including IEBUPDAT 23 

for initializing system residence 
volume 7-8 

initializing system data sets 8,10-11 

organization 20-21 

sample programs 93-120 
Instruction set 

commerical 267 

scientific 247,301 problems 79-82 

specified 254-255 processing 1-2 

universal 247,267,301,371 punching 21-22 

Integrated opereitor console sample steps 69-71 

(see Model 85, 5450) tape to cards 82 

Interruption Job termination 403,407 

machine 80 Job step CPU timing function 402,446 
IOCONTRL macro instruction 

additional devices 479 

C3:*oss-ref erence table 469 ^^ 

specifying 331-336 flj 

type of (table) 244 ■" 

IODEVICE macro instruction L5J3EL parameter 

additional devices 475-480 " DD statement, initialization 9,10 

cross-reference table 469 DD statement, input deck 20-22 

specifying 337-353 Labels 

type of (table) 244 n °lahel«* 307 

IPL 10,11,279,405,407,408,410,441,444,445 non-sta-.dard 24,449 

h™ to obtain 7 standard 307 

included in 33 Language processors 

* e '/ 98 " 120 example 2-3 

ISAM „ A „ included in 2,30 3 

component name 20 5 Libraries 

descriptor! of option 175 (see operat ing system libraries) 

to be induced 2 81 Linkage editor 

I/O device generation 418 alias 291-292,301 

description 3 contained in 220 

examples 2,3,145-147 component names 20 5 

macro instructions used 244 durincr Stage II 2,84,87 

restarting link edit steps 84 „ j qc ,^„„ il„«i one ->ci ncn ->on :nt aac 

requirements 253,257,275,281,319,325, Input ?o tTs t 31S 319 

331,337,347,421,425,439,451,453,461, performance considerations 206 

,. ,„ i print options 312 

I/O recovery management le s 65 ?] _ 

(see alternate path retry, dyncimic siz ^ requi £ ed 313 

device reallocation, error recovery tQ be ^ cluded 2 92-293 

routines) use Qf 2 , 65, 71, 251, 267, 291, 295, 435 

uses utility data sets 28,32,307,316 
(see also link edit steps) 
Link edit steps 

JCL job stream — Stage II 65-76 

created for Stage II 20 non-TSO generation 65-71 



required 20 
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restarting 84,87 

TSO generation 71-76 

non-TSO 8 '4 
Link library 

(see SYS1.LINKLIB) 
Link library list 

(see SY51.PARMLIB) 
LINK macro instruction 

uses SYS 1 . LINKLIB 2 20 
Link pack area 179 
LINKEDIT 

alias 291 
LINKLIB macro instruction 

specifying 355 

type of (table) 244 

user~v?ritten modules 23-24 
LNKLST00 

(see SYS1.PARMLIB) 
LOADER macro instruction 

cross-reference table 460 

specifying 357-359 

type of (table) 2 44 
Loader program 

component name 205 

macro instruction 3 57-359 

notes about coding 359 

planning for 359 

specifying 357-3 59 

test program 112 
LOAD macro instruction 

(see SYS 1. LINKLIB) 
Log option 

description 165-168,405 

specifying 405-406,410 



M 



Machine- check handler (MCH) 

part of SER 445 

(see also SYS1.ASRLIB) 
Machine-check handler library 

(see SYS1.ASRLIB) 
Machine configuration 

considered in 1,14 

examples 123-125,133-135 

macro instructions 244 

M65MP 2 55 

starter system requirements 34 
Machine interrupt 80 
MACLIB macro instruction 

specifying 361,362 

type of (table) 2 44 
Macro instructions 237-472 

coding conventions 239 

cross-references 467-472 

description 240 

table of 244 

unit name in 242 

(see also individual macro instructions) 
Macro library (see SYS 1. MACLIB) 



Magnetic tape 

control units 332-336 

devices 337-353 

nonstandard label routines 24 

restarting from 81-83 

standard labels 307 

use of 21 ,82,270 

user label scinple program 120 
(see also 9-track magnetic tape) 
Main storage hierarchy support 

description 176-177 

specifying 275-277 
Master scheduler 

uses SYS 1 . PARMLIB 227 
MCH 

(see machine-check handler) 
HCS 

(see multiple consoles support) 
MFT 

considerations 2 5 

log data, sets 234,414-415 

minimum partition 408 

job scheduler for 397-398 

options 397-398,440-444 

partitions 

(see PARTITNS macro instruction) 

requirements 244,367-370,408,448 

task supervisor options 440-444 

time-slicing 279-280 

type of generation 2,3 

with SMF 225 
Model 30 

requirements 253 

restrictions 253-254 

specifying 253,255-256 
Model 40 

requirements 253 

restrictions 253-254 

specifying 253,255-256 
Model 50 

specifying 253,255 
Model 65 multiprocessing 

component name 205 

job scheduler for 401-402 

log data sets 234 

machine-check handler (MCH) 445-446 

options 401-402 

requirements 208,244,255,440-446 

restrictions 255,277,336 

task supervisor options 440-444 

to be included 276,279-280 



types of generation 2 


!,3 




Model 67 








in 65 mode 


37 






Model 75 








specifying 


253 






Model 85 








channel-check handler 


(CCK) 


441 


machine-check handler 


(MCH) 


445-446 


specifying 


253 






system error recovery 


(SER) 


445-446 
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with starter operating system 36 

5450 326-339 
Model 91 

instruction set 253-254 

restrictions 255,275,421 

specifying 253 

with COBOL 265,268 

with FORTRAN 297 

with starter operating system 34,35 
Model 135 

CCH 1 62 

requirements 221,232,275 

specifying 263-265 
Model 145 

CCH 162 

requirements 232,275 

specifying 253-255 
Model 155 

channel-check handler (CCH) 441 

data sets 212,220,232 

devices, additional 482 

emulators 293 

I/O device 3210 338,353,416-418,430 

I/O device 3215 338,353,416-418,430 

machine-check handler (MCH) 445-446 

restrictions 275,277,421 

specifying 253-255 
Model 158 

data sets 212 

I/O device 3213 338,351,419,430 

restrictions 275,277 

specifying 253-255 
Model 165 

channel-check handler (CCH) 441 

data sets 212,220,232 

devices, additional 482 

emulators 293 

I/O device 3066 338,339,353,417,419 
430,480 

machine-check handler (MCH) 445-446 

restrictions 275,277,421 

specifying 253-255 

start operating system 36-39 
Model 168 

data sets 212 

emulators 293 

restrictions 275,277 

specifying 253-255 

start operating system 36-39 
Model 195 

channel-check handler (CCH) 441 

instruction set 255 

requirements 253-255 

restrictions 2 55,275 

system error recovery (SER) 445 

specifying 253-255 

with COBOL 265 

with starter operating system 34,35 
MOUNT command 

during restart 82 
Multiple consoles support (MC3) 

alternate console 165-168 

buffers 414 

command code groups 165 

component name 205 



composite* console 398-402,403-405 

description 165-168 

devices can be used 416-419,430 

placed in 205 

SECONSLE macro instruction 165-168, 
425-430 

specifying 393-401 , 402-405,425-430 

system log 165-166,405 

system log data sets 234 
Multiple extents 220 
Multiplexer channel 257,334 

restriction 257 

specifying 257 
Multiprogramming fixed number of tasks 

(see MFT) 
Multiprogramming variable number of tasks 

(see MVT) 
MVT 

component name 205 

considerations for 25 

iob scheduler for 399-401 

log data sets 234,410 

minimum region 408 

options 399,4 40-444,461 

requirements 244,291,301,448 

rollout/roll in 277 

simple generation 133-147 

task supervisor options 440-4 44 

tine sharing 187 

time slicing 279 

type of generation 2,3 
M65MP (see Model 65 multiprocessing) 



NAME keyword 

UNITNAME macro instruction 242,463-465 
New operating system 

catalog data sets 2 8-32 

data sets for 207-20 8 

definition 1,3 

examples of allocation 15-20 

examples of initializing 10-15 

initializing data sets 7-13 

libraries constructed 2 

types of 2-3 
New system (see new operating system) 
NIP 

uses SYS 1 . PARMLIB 227 
Nonstandard label routines 23-24,450 
Nucleus 275,443-445 

member name 312 

user/written programs 23-24 

(see also SYS 1 .NUCLEUS) 
Nucleus generation 

definition 2 

examples 4 

macro instructions for 244 
Nucleus initialization program (see NIF) 
Nucleus library (see SYS 1 .NUCLEUS) 
Nucleus modules, refreshable 

(see SYS1 .ASRLIB) 
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Null allocation 

for SYS 1. PARMLIB 
for SYS1 .FROCLIE 



365 
389 



H 



Object modules 

from Stage TI 65,71,314 
OBJPDS 65,74 

reallocation 88 

restart DD statement 65,84,87 
OBJPDS keyword (GENERATE macro 

ins truction ) 314 
OCR (see optical character reader, 1285, 

12 87, 1288) 
OIU (optical image unit) 

specifying 3 43,3 50 
Online test executive urogram (OLTFP) 

buffers 415,442 

component name 205 
Operator 

action 10,15-21 

communications facility 441 
Optical character reader 

error routines made resident 232,443 

excluding 362 

specifying 338-339,3 48,444 

(see also 1285,1287,1288) 
Optical image unit (see OIU) 
Optimize 

COBOL 270 

FORTRAN 303 

PL/I 376-377 
OS/360 Loader (see Loader program.) 
OUTPUT macro instruction 

cross-reference table 469 

specifying 363 

type of (table) 243 
Overlay supervisor 278 



Parameter library 

(see SYS1 .PARMLIB) 
PARMLIB macro instruction 

specifying 365 

type of (table) 24 4 
PARTITNS macro instruction 276-277 

cross-reference table 468-469 

specifying 370 

type of (table) 244 
PCI (see program controlled interrupt) 
PL1LIB macro instruction 325,371,439 

cross-referencs table L '69,471 

specifying 381-387 

type of (table) 2 44 
PI.1 macro instruction 381 

cross-reference table 467,469,472 



specifying 371-379 
type of (table) 2 44 
PL1SAMP (see graphic subroutine package — 

sample programs) 
PL/I compiler 442 

automatic restart 261 

component name 20 5 

example 4 

generator, of 371-379 

graphic subroutine package (GSF) 32 5 

optimizing 375-376 

graphic subroutine package (GSP) 325 

optimizing 375-376 

sample display 110 

sample program 108-110,113 

syntax checker 

component name 205 
specifying 259-260 
use of 168,169,259,305,378 
to be included 205,371 

(see also PL/I library, SYS1 .PL1LIB, PL1 
macro instruction, PLlLIB macro 
instruction) 
PL/I F sample program 113 
PL/I library 

component name 205 
shared library 

description 177 
feature 383,387,469 
specifying 381-387 
(see also SYS 1. PL 1 LIB, PL/I compiler, 
PL/I library, PL1 macro instruction, 
PL1LIB macro instruction) 
PL/I shared library feature (see PL/1 

library) 
POST module 443 

Power warning feature 276,280,338,346 
PRESRES list 

included in 227 
use of for MVT 25 
(see also SYS1 .PARMLIB) 
Primary console 

description 163-164 
specifying 405 
Print output class 322 
Priority number 321 
Procedure library (cataloged) (see 

SYS1.PROCLIB) 
Processing programs 

macro instructions 244 
Processors 3-4 

Generation requirements 204 

(see also individual processors) 
Processor to processor (see PTOP macro 

instruction) 
Processor/library generation 3-4 

definition 3 

example 130-131 

macro instructions for 244 
PROCLIB macro instruction 

cross-reference table 469 

specifying 389,390 

type of (table) 244 
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Program controlled interrupt (PCI) option 

description 178 

specifying 276 
Program options descriptions 

additional pairs of transient areas 157 

alternate path retry (APR) 157 

ATTACH function 158 

ATTACH function made resident 159 

basic direct access method (BDAM) 160 

BLDL table made resident 160 

channel-check handler (CCH) 162 

checkpoint/restart facility 162 

consoles — alternate and composite 
consoles options 163-164 

consoles — multiple consoles support 
(MCS) 164-168 

conversational remote job entry (CRJE) 
facility 168,169 

decimal simulation option for 
model 91 170 

direct-access volume serial number 
verification 170 

dynamic device reconfiguration 
(DDR) 171,172 

EXTRACT function made resident 173 

graphic programming services 174 

IDENTIFY function made resident 174,175 

indexed sequential access method 
(ISAM) 175 

job queue made resident 175 

job step timing 176 

main storage hierarchy support 176 

multiple wait option 177 

PL/I F shared library feature 177 

program controlled interrupt (PCI) 178 

reenterable load modules made 
resident 179 

remote job entry (RJE) facility 180 

resident access method routines 180 

rollout/rollin option 182 

shared DASD 182 

SPIE routines made resident 183 

storage protection 183 

system management facilities (SMF) 184,185 

telecommunications option 186 

timing options 186,187 

time sharing option (TSO) 188 

time-slicing facility 190 

trace option 191 

transient SVC table made resident 192 

type 3 and 4 SVC routines made 
resident 193 

user-added SVC routines 193 

validity check option 194 

volume statistics facility 195,196 
Protected data set 1 
Protection function 

central processing unit 253 

programming 443 
PTOP macro instruction 322 

cross-reference table 468,469 

specifying 391,392 

type of (table) 2 44 
PTOP sample program 103 



Punch output 

cards 65,71,81 

classname 322 

restarting 81 
PWF (see Power warning feature) 



B 



OISAM 2 82 

(see also ISAM) 
QTAM 

component name 2 05 

description 186 

to be excluded 361,362 

to be included 281 
Queued indexed sequential access method 

(see QISAM, ISAM) 
Queued telecommunications access method 

(see QTAM) 
Queueing I/O requests 345 



RA.M list 

included in 227 
(see also SYS1 . PARMLIB) 
RD parameter 

use with checkpoint/restart 162,261,371 
Reader 

sample program use 98,120 
Reallocation 

OBJPDS 8 8 

on same volume 89-91 

on the same space 89-91 

SYSUT1, SYSUT2, SYSUT3 89-90 

SYS 1 . SYSJOBOE 94 

with more space 91-93 
Recovery management support (RMS) 2 05 

(see also Model 85) 
Reenterable load modules made resident 

description 179 

specifying 445 
Region 

minimum 408 

size 321 
Remote job entry 

component name 205 

description 180 

requirements 281 

specifying 410 
Reply queue elements 

number for write-to-operator ( T * T TOR) 410 
Report program generator (see RPG) 
Requirements 

starter system 34-35,37 
Resident access methods 

description 181 

specifying 443-445 
Resident supervisor functions 443-445 
RFSMODS macro instruction 451 

cross-reference table 469,471 

specifying 393,394 

type of (table) 2 44 
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Restart 

ASMBLR steps 8 4,86 

automatic 261 

from cards 81 

from tape 81-83 

IEBCOPY step 8 4-85,88 

IEHIOSUP step 86,88 

IEHLIST step 86,88 

IEHPROGM 84,87 

IEWL steps 84-85,87 

IFCDIPOO step 86,88 

procedures 79-84 

reallocation of data sets 88-94 

Stage I 79-80 

Stage II 80-84 

techniques 81-84 
RESTART parameter (JOB card) 261 
RMS (see recovery management support, model 

85) 
Rollout/roll in function 

description 182 

specifying 277 

system data set 230 

(see also SYS 1 . ROLLOUT) 
Routing codes 

description 165-168 

specifying 398-402,405-406 
RPG macro instruction 

specifying 395 

type of (table) 244 
RPG processor 

component name 205 

sample program 1 1 4-1 1 6 

(see also RPG macro instruction) 
RPGSMPL (see RPG sample program) 
RSVC list 

included in 227 

(see also SYS1 .PARMLIB) 



Sample accounting routine (SAMACTRT) 1 1 6 

description 33 
Sample library (see SYS1 .SAMPLIB) 
Sample programs 97-120 

ALGOL (IEXSAMP) 98 

American National Standard COBOL 
(IKFSAMP) 99 

assembler (IEUESP) 100 

COBOL E (IEPSAMP) 101 

data generator sample program 
(IEBDATGN) 102 

data transmission and conversion 
subroutines (IKDSAMPL) 103 

FORTRAN G & H (IEYSP) 104 

graphics (SAMP2250 and 
SAMP2260) 105-107 

graphic subroutine package 108-110 

IEHDASDR system utility (DRISAMP) 111 

loader program test program 112 

names of 97 

PL/I F (IEMSP2) 113 

RPG (RPGSMPL) 114-115 

sample account routine (SAMACRT - ) 116 

sort/merge (IERSP) 117 



update analysis program 
(IHGSAMP) 118-119 

user label 120 

(see also SYS1 .SAMPLIB) 
SAMP2250 (see graphics 2250 sample program) 
SAMP2260 (see graphics 2260 sample program) 
Satellite graphic job processor 

component name 206 

to be included 322 
SCHEDULR macro instruction 

cross-reference table 467-471 

specifving 397-420 

type of (table) 2 44 
Scratch volume 

use during restart 85,87 
SECMODS macro instruction 445 

cross-reference table 470,471 

specifying 421-423 

type of (table) 244 
Secondary allocation 208 
Secondary console 

(see SECONSLE macro instruction) 
SECONSLE macro instruction 325,403,405 

cross-reference table 469,471 

specifving 425-430 

type of (table) 244 
Selector channel 

specifying 257 
Selector subchannel 346 
SER 422,445-446,448 

component name 206 
Service aids 

(see SYS1.DN554 and SYS1.DN554A) 
SER0 (see SER) 
SER1 (see SER) 

SGJP (see satellite graphic job processor) 
SHARABLE 

description 344,345 
Shared DASD option 

description 182 

specifying 333,334,343,344,444 
Shared library for PL/I (see PL/I library) 
SMF 

data sets 225 

description 184-185 

requirements 409,446 

sample programs* 33 

specifying 398,402,408,446 
SMF definition list (SMFDEFLT) 

(see SMF) 
SMFDEFLT (see SMF) 
Sort library 227 

component name 206 

(see also SYS1 .SORTLIB, SORTLIB macro 
instruction) 
SORTLIB macro instruction 

cross-reference table 471 

required 435 

specifying 433-434 

tvpe of (table) 244 
SORTMERG macro instruction 433-434 

cross-reference table 471 

specifying 435-438 

type of (table) 244 
Sort/merge component name 206 
Sort/merge sample program 1 1 7 
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Space allocation 

(see also the OS Storage Estimates manual) 

done by TEHPROGM 9 

example 10-15 

for ALGOL library 245 

for COBOL 2 67 

for COBOL library 265 

for FORTRAN library 2 95 

for generation 22,308,315,316 

for GJP or SGJP 319-32 

for LINKLIB 247,251,267,301,355,371, 
395,435 

for MVT 2 5 

for minimum region 408 

for nucleus 393,412 

for parameter library 365 

for partitions 367-369 

for PL/I 372-377 

for PL/I library 378 

for procedure library 389 

for sort/merge library 433 

for SYSJOBOE" 407-408 

for system macro instructions 361 

for telecommunications library 3 91 

for write-to-operator (WTO or WTOR) 415 

for write-to-log (WTL) 414 

new system data sets 207-236 

reallocation during restart 88-94 

restarting Stage I 79-80 

restarting Stage II 80-84 

utility data sets 26,28,32 

(see also system data sets) 
SPACE parameter 

DD statement, initialization 10 

values, utility data sets 21 
SPIE function 445 
SPIE routines made resident 

description 183-184 

specifying 445 
Stage I 

coding macro instructions 20 

description 1 

errors 79 

generation library (see SYS1.GENLIB) 

input deck 20-22 

product of 65,71 

restart procedures 80-84 

sample program 1 1 8-1 1 9 

sample restart deck 80 

space allocation 21 

system generation macro 
instructions 245-472 
Stage II 

assemblies 2 

considerations for MVT 25 

description 1-2 

errors 80 

generation library (see SYS1.MODGEN) 

input 1 

link edit 2 

output data sets 315-316 

processing 1-2 

restart procedures 80-94 

sample program 118-119 

user-written functions 23-24 

(see also job stream) 



Status displays 

description of 165-166,168 

specifying of 397-401,406,409,426-429 

use 415 
Starter operating system 33-62 

contents 33-34 

contents of SYS1 .SAMPLIB 33 

data sets 33-35 

deleting libraries 59 

distribution 483 

example 136-138 

processing 40-59 

renaming data sets 30 

requirements 34 

sample initialization 136-137 

unit names 3 9 

3330 32-35,42,123-132 
START RDR command 81,82,412 
START WTR command 413 
Storage hierarchies 275-277 
Storage protection 

description 184 

specifying 443,448 
Storage requirements (see individual 

program options descriptions) 
Subchannel (see selector subchannel) 
Subtasking (see ATTACH function) 
SUPRVSOR macro instruction 439-447 

cross-reference table 471 

specifying 439-447 

type of (table) 244 
SVC library (see SYS1.SVCLIB) 
SVC routines 

resident 393 

transient 449 

type 1 and 2 451 

type 3 and 4 445,451 

user-written 393,449,451 
SVC table 443 
SVCLIB macro instruction 449,450 

cross-reference table 471 

specifying 449,450 
SVCTABLE macro instruction 451,452 

cross-reference table 471 

specifying 451,452 

type of (table) 24 4 
Synchronous overlay 27 8 
Syntax checker 

component names 204 

for FORTRAN 259-260,305 

for PL/I 259-260,378 

specifying 259-260 

with CRJE 170 
SYSCP 463-465 
SYSCTLG 

description 209 

required 208,209 

serial number 10 

space allocation 209 
SYSDA 463-465 
SYSIN data set 9,10 

used during restart 79,80,81,82 

use of 90-92 
SYSOUT data set 322 

used during sort/merge 438 
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SYSPRINT data set 7,27,315 

use of 69-71,72-73,79-83 
SYSPUNCH data set 88,89,90,91,93 

purpose 22 

use during restart 80 

use of 69-71 ,75-76 
SYSSO 463-465 
System catalog (see SYSCTLG) 
System commands and responses with multiple 

consoles 165 
System data sets 199-236 
System environment recording (see SER) 
System error recovery (see SER) 
System generating libraries 

(see SYS1.GENLIB, SYS1.MODGEN, component 
libraries) 
System generation macro instructions 

(see macro instructions) 
System input unit 

(see SYSIN) 
System libraries 

(see individual operating system 
libraries) 
System log data sets 

(see SYS1.SYSVLOGX, SYS 1 . SYSVLOGY) 
System macros library 

(see SYS1.MACLIB) 
System management facility 

(see SMF) 
System output unit 

(see SYSOUT data set, SYSPRINT data set, 
SYSPUNCH data set) 
System queue area 

specifying 278 
System residence volume 

data sets on 7,208 

initializing 7-8 

space allocation 7-10,12-14 

(see also initialization) 
System utility programs 

example 111 

IEBPTPCH 30 

IEBUPDAT 2 3 

IEBUPDTE 2 3,319 

IEHLIST 27 

IEHPROGM 31-32 

use of 2,21-22,29-32,301,381,433,435 
SYSUTILS macro instruction 

specifying 453 

type of (table) 244 
SYSUT1 

DD statement 20-23 

reallocation 89-90 

space allocation 21 

use during restart 75-76,85,87 

use of 21-23,24 
SYSUT2 

DD statement 20-23 

reallocation 89-90,93 

space allocation 21 

use during restart 75-76,85,87 

use of 21-23,24 
SYSUT3 

DD statement 20-23 

reallocation 89-90 

space allocation 21 
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use during restart 75-76,85,87 

use of 21-23,24 
SYSUT4 

DD statement 20-23 

reallocation 89-90,93 

space allocation 21 

use of 20-23 
SYS1.ACCT 208,210 
SYS1.ALGLIB 208,211 

generated from 2 04 

INDEX parameter 29,31,33 

reallocation 87,80 

specifying 245-246 

to be included 2 46 

user assigned qualifier 312 

(see also ALGOL macro instruction, 
ALGLIB macro instruction, ALGOL 
library) 
SYS1.ASRLIB 208,213 

initialized 65 

requirement 445 

restart DD statement 85 

user assigned qualifier 312 
SYS1.BRODCAST 2 08,213,457 

(see also time sharing option) 
SYS1.CMDLIB 208,214,264,317 

(see also time sharing option) 
SYS1.COBLIB 208,215,326" 

catalog 27,29 

generated from 204 

INDEX parameter 29,31,33 

reallocation 87,80 

rename 29 

requirements 2 9,268 

specifying 265-266 

user assigned qualifier 312 

(see also COBOL macro instruction, 
COBOL library, COBLIB macro 
instruction) 
SYS 1 . DCMLIB 2 1 6 
SYS1 .DN554A 

description 33 

distribution of 33,484-486 
SYS1.DN554 distribution 206 
SYS 1. DUMP 208,218 

exception 8 
SYS1 .FORTLIB 208,219 

catalog 27,295 . 

generated from 204 

generation of 313 

INDEX parameter 2 9,30,31,33 

reallocation 84-85,86-88 

rename 30 

space allocation 296 

specifying 2 96 

user assigned qualifier 312 

user-written modules 30 

(see also FORTRAN macro instruction, 
FORTLIB macro instruction, FORTRAN 
library, FORTRAN compiler, FORTRAN 
subprograms) 
SYS1.GENLIB 201 

assembler requirements 251 

catalog 27,30 

demounting 1 5 

distribution 38,484-486 

(see also SYS1.MODGEN) 



SYS 1. HELP. 208,220,326 

(see also time sharing option) 
SYS 1 . IMAGELIB 149-150,208,220 
SYS1.LINKLIB 208,220,313-314 

INDEX parameter 2 9,30,31 

I/O device generation 3,308 

mounting 1 5 

nucleus generation 307 

performance considerations 15 

printing of 311 

processor generation 308 

reallocation 80,87 

space allocation 10 

specifying 355 

use of 179,445 

user assigned qualifier 312 

user-written programs 24,355-358 

64K 25 
SVS1.LOGREC 2 08,22 4 

I/O device generation 3 

printing of 314 

restarting DD statement 84,85 

user assigned qualifier 312 
SYS1.MACLIB 208,225 

catalog 27,361 

demounting 1 4 

distribution 34,483-486 

generated from 2 06 

generation of 68,80,361-362 

INDEX parameter 2 0,30,31 

in starter operating system 29-30 

mounting 1 4 

rename 2 9-3 

requirements 361,362 

restart 84-85 

specifying 361-362 

uncatalog 27-28 

user assigned qualifier 312 
SYS 1. MANX 208,225 
SYS 1. MANY 208,225 
SYS 1 . MODGEN , S YS 1 . MODGEN 2 201 

catalog 26-27 

demounting 1 5 

distribution 33-34,484-486 

mounting 1 5 

save 4 86 

(see also SYS1.GENLIB) 
SYS 1. NUCLEUS 10,208,226 

catalog 393 

generation of 315 

INDEX parameter 29,30,31 

mounting 1 5 

performance considerations 15 

reallocation 87 

serial number 10 

user assigned qualifier 312 

user-written modules 393 
SYS1.PARMLIB 208,227 

catalog 26-27 

catalog if 365 

generated from 205 

generation of 365 

INDEX parameter 2 9,30,31 

in starter operating svstem 30 

null allocation 10,365 

reallocation 86 



specifying 365 

use of 359 

user assigned qualifier 312 
SYS1.PL1LIB 3,208,228 

catalog 28,381 

description 381-382 

generated from 2 05 

generation of 381-382 

INDEX parameter 29,30,31 

reallocation 86 

rename 30 

space allocation 381 

specifying 381-3 87 

user assigned qualifier 312 

(see also PL/I library, PL1LIB macro 
instruction, PL/I compiler) 
SYS1.PROCLIB 208,209 

generated from 205 

generation of 389-390 

GJP cataloged procedures 319 

INDEX parameter 2 9,30,31 

in starter operating system 30 

planning for 26-28 

null allocation 10,3 89 

rename 2 8-30 

SGJP cataloged procedures 319 

specifying 389-390 

user assigned qualifier 312 
SYS 1. ROLLOUT 20 8,230 

example 1 1 
SYS1.SAMPLIB 33 

contents 7,97,184-185 

obtaining 98 

sample programs 97-120 
SYS1 .SORTLIB 208,231 

catalog 27-28 

generated from 206 

INDEX parameter 29,30,31 

rename 28-30 

scratched 433,435 

specifying 43 3 

user assigned qualifier 312 

(see also SORTLIB macro instruction, 
SORTMERG macro instruction) 
SYS1.SVCLIB 208,232 

generation of 450 

INDEX parameter 29,30,31 

I/O device generation 3 

limit 449 

mounting 1 5 

performance considerations 15 

printing of 311 

serial number 10 

user-written programs 2-4,449 

user assigned qualifier 312 

64K 25 
SVS 1 . SYS JOBOE 20 8,233 

expiration date 10 

reallocation 93-94 

resident 413 

SUPRVSOR keyword parameter 416 
SYS 1 . SY S VLOGX ^208,234 

buffer 414 
SYS 1 . SYSVLOGY 208,234 

buffer 414 
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SYS 1 . TELCMLIB 208,235 
BT AM 2 8 1 

generated from 2 07 
generation of 455-456 
INDEX parameter 29,30,31 
QTAM 2 8 1 

reallocation 85,87 
user assigned qualifier 312 
(see also TELCMLIB macro instruction, 
telecommunications library) 
SYS1.TSOGEN 20 3 

(see also time sharing option) 
SYS1.UADS 208,236,459 

(see also time sharing option) 
S360 

specifying 340,351 
S370 

specifying 254 



Task supervisor options 43 9-4 47 
TCAM 

cataloging 2 8 

component 206 

description 186 

to exclude 361 

blocking factor 483-486 
job stream-Stage II 68,71 
TELCMLIB macro instruction 391 

specifying 455 

type of (table) 2 44 

use of 186 
Telecommunication access method 

(see TCAM) 
Telecommunication devices 337 
Telecommunications library 281 

component name 206 

to be included 455 

(see also SYS 1 .TELCMLIB, TELCMLIB 
macro instruction) 
Telecommunications lines 337,343-344 

transmission adapter 34 
Telecommunications subroutines 

contained in 455-457 

(see also SYS 1 .TELCMLIB) 
Terminal devices 3 43 
Timer 

feature 254 

specifying 439,455 
Time-slicing 

description 190 

specifying 279-230 
Timing options 

description 186-187 

specifying 402,439,446 
Time sharing option (TSO) 188-189 

distribution library 483-486 

examples 17,76,149-153 

guidelines for restarting Stage IT 
36-88 

job stream Stage II 7 1 —76 



Trace option 

description 191 

specifying 43 9,446 
Trace table 4 46 
Track stacking 407 
Transient area 276 
Transient SVC table option 

description 192-193 

specifying 367 

(see also SVC routines, SVC table, 
SVCTABLE macro instruction) 
TSO 

(see time sharing option) 
TSOPTION macro instruction 

specifying 457 

type of (table) 244 

(see also time sharing option) 
TWX 

specifying 33 8,341,351 
Type 3 and 4 SVC routines made resident 

description 193 

specifying 44 5 

(see also SVC routines, SVCLIB macro 
instruction) 
Types of generation 2-3 
"table 244 



UADS macro instruction 

specifying 459 

type of (table) 2 44 

(see also time sharing option) 
UCS macro instruction 

cross-reference table 472 

specifying 461-462 

tvpe of (table) 2 44 
UNCT231 1 

description 32 

included in 33 
UNCT2314 

description 32 

included in 33 
Unit address 

definition 2 42 
Unit name 

(see device tyoe) 
UNIT PARAMETER 

DD statement, initialization 9,10,22 

JCL for Stage II 69-71 

SYSPUNCH DD statement 21-22,81 
UNITNAME macro instruction 320,337,389 

additional devices 479 

cross-reference table 472 

specifying 463-4 65 

type of (table) 475-477 
Universal character set 

specifying 461-462, 344 

with starter operating system 35 
Universal instruction set 

COBOL 267 

FORTRAN 301 

PL1 371 

Specifying 254 
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Update analysis program 97 

sample program 118-119 
User label sample program 97,120 
User totaling facility example 

(see user label sample program) 
User-written functions 

error routines 343 

for FORTRAN 2 06,295 

include in 2*i ,295 ,355,393 ,449, 451 

macro instructions 244 

nonstandard label routines 445 

space allocation 355,393 

SVC 449,451,452 

SYS 1 . LIITXLiB 2 4,355 

SYS 1 . NUCLEUS 2 4,39 3 

SYS 1 . SVCLIB 2 4 
User-written modules 

(see user-written functions) 
User-written programs 

(see user-written functions) 
User-written SVC routines 

description 193 

specifying 34 3,393,449 

(see also user-written functions) 
Utility data sets 

catalog 22,28 

deleting 79,307 

demounted 1 4 

during restart 79 

example of allocation 15-20 

example of scratching 130 

for generation 20-22,29,32 

mounting 14-15,59 

names for 20 

reallocation 88-94 

required 14,26-28,29-30,32 

reside 2 

scratch 22,79 

sizes 21 

space allocation 11,21,28,32 

specifying 20-22,307,315-316 

(see also system data sets) 
Utility programs 1,33,111 

during Stage I 65 

during Stage II 1,65,74 

examples 126-127,129,136-137,140-141 

storage available for 453 

uses utility data sets 32 
(see also svstem utility programs) 
UT1SDS keyword (GENERATE macro 
instruction) 

requirement 307 

specif ving 309,316 
UT2SDS keyword (GENERATE MACRO 
instruction) 

requirement 307 

specifying 309,316 
UT3SDS keyword (GENERATE macro 
instruction) 

requirement 3 07 

specifying 309,316 



WAIT macro instruction 446 
WAIT options 4 46 



Validity check option 

description 194 

specifying 443 
Verify DASD volume serial number 442 
VOL parameter 9,11 
Volume index 

for SYSCTLG 7,8 
Volume initialization 

CATLG statements 10 

DD statements 10 

description 7 

example 7 

performed by 7 
Volume label 71 
Volume mounting 

requirements 14-15 
VOLUME parameter 9,10 
Volume serial number 9,10,11,39 
Volume statistics 

description 195-196 

SMF requirements 195,196,402 
Volume table of contents 

(see VTOC) 
VTOC 7,8 

WTP 

(see wr i te-to -programmer } 
Write-to-log messages (WTL) 

buffers 413-415 

(see also SYS 1 . SYSVLOGX , SYS 1 . SYSVLOGY) 
Write-to-operator 

buffer default sizes 414 
message buffers 414 
messages contained in 23 4 
Write-to-operator routines (WTO and/or 
WTOR) 

(see write-to-onerator) 
Wr i te- to-pr ogr ammer 

mess acre buffers 407- '408 
WTO 

(see write- to-over ator) 
WTOR 

(see write-to-operatcr) 
WTR 

(see Writer cataloged nrocedure) 
WTTA 

specifying 338,341 



XCTL macro instruction 
(see SYS1.LINKLI3) 
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7- track magnetic tape 

for utility data sets 413 

use of during generation 22 
83B3 

specifying 338,341,350 
115A 

specifying 338,341,350 
1030 

specifying 33 8,348 
1050" 

specifying 338,341,348 
1050X 

specifying 3 38,339,343,344,348 
1051 

specifying 334 
1052 

device type 476 

speci f ving 334,338,34 8,350 
105 3 

device type 47 6 

specif ving 33 8,34 8 
1060 

specifving 338,341 ,343,344,348 
1130 

specifving 338,341,348 
1275 

device type 47 6 

restriction 3 38 

specifyina 338,342,348 
1285 

error routines made resident 44 4-445 

specifying 333,343,444-445 
1287 

error routines made resident 444, a 45 

specifving 338,348,444,445 
1288 

error routines made resident 444,445 

specifying 338,348,444,445 
1403 

device type 476 

specifving 338, 343, 344 ,348, 350 
140 4 

speci fvina 350 
1419 

specifying 338,342,345 
1442' 

device type 476 

specifying 338,3 48 
1143' 

device type 476 

specifying 338,343,344,348 
2020 

speci fyincr 3 38,339,341,3 48 
2150 

specifving 350 
2250 

snecifving 338,339,343,344,3 46,349, 
353.376 
2260 

specifving 33 8,3 39,343,344,3 49,353 
2265 

specifving 338,341,349,353 
2280 

specifying 176,338,343,344,349 



2282 

specifyina 338,343,344,349 
2301' 

device type 475 

specifying 338,347,3 49 

svsten residence 8,315 
2302 

device type 475 

specifying 337,338,347 ,349 
2303 

device type 475 

specifying 338,347,349 

system residence 8,315 
2305 

device tyne 475 

specifying 337,338,347,349 

svstem residence 8,315 
2311 

device type 475 

specifying 337,338,347,349 

system residence 8,315 
2314" 

device type 475 

specifyina 337,338,343,344,347,349 

system residence 8,315 
2319 

device type 493 

specifying 340 
2321 

de\ r i c e typ e 475 

specifying 338,347,343 

use of 465 
2400 

device type 475 

specifving 344 
2401 

specifying 337,33 8,3 43,3 44,346,349 
2402 

specifying 337,338,343,344,346,349 
2403 

specifying 3 34,343,344,346,349 
240 4 

spe at f ving 334,3 37,333,343,346,350 
2415 

specifying 3 33,334,33 8,34 3,34 4,350 
2 420 

specifyina 337,333,3 46,350 
2495 

device type 476 

restriction 340 

specifying 338,343 
2501 

device type 476 

specifying 338,350 
2520 

device type 476 

specifying 33 3,350 
25 4 OP 

device type 476 

specifying 338,340,350 
2540R 

device type 47 6 

specifying 33 3,340,350 



514 OS System Generation 



2596 

description 

specifying 
2671 

device type 

specifying 
2701" 

specifying 
2702 

specifying 
2703*" 

specifying 
2715 

BSCA 341 
2740 

specifying 
2740C 

specifying 
27 4 OX 

specifying 
2741* 

specifying 
2741C 

specifying 
2741P 

specifying 
2760* 

(see OIU) 
2790 

specifying 
2803 

specifying 
2816 

specifying 
2820 

specifying 
2821" 

specifying 
2822 

specifying 
2840 

specifying 
2841 

specifying 
2844" 

specifying 
2845* 

specifying 
2848 

specifying 
2880 

specifying 
2972 

specifying 
2955 

specifying 
3066 

specifying 
3158 

device type 

specifying 



443 
339 

476 
338,350 

333,334,341,345,353 

333,334,341,345,353 

333,334,341,345,353 

338,341,344,350 

338,340,350 

338,340,350 

341 

338,340,350 

338,340,350 

176,186,388,341,343,344,351 

33 4 

334 

334 

334 

334 

334,340 

334,346 

333,343,344 

353 

333,335,343.353 

258 

341 

338,341 

338,340 

38,476 
338,351,427,430 



3210 

specifying 338,351 
3211 

device type 477 

specifying 338 
3213 

device type 38,476 

restrictions 419,432 

specifying 338,351,430 
3215 

specifying 338,477 
3277 

device type 476 

specifying 351,417,431 
3284 

device type 476 

specifying 351,419,431 
3286 

device type 476 

specifying 351,419,431 
3330 

device type 4 75 

distribution 487,488 

specifying 337,338,340,347,352 

starter operating system 32-39,42, 
123-132 

system residence 8,315 
3333 

device type 493 

specifying 34 
3410 

device type 39,475 

specifying 333,336,338,343,352 

use 37 
3420 

device type 39,475 

specifying 338,343,344,352 

use 37 
3505 

device type 39,476 

specifying 338 

use 37 
3525 

description 343,344 

device type 39,476 

specifying 338 

use 37 
3704 

specifying 338,341,346,347,352 
3705 

specifying 337,338,341,346,347,352 
3803 

specifying 333,334,336 
5450 

device type 476 

specifying 338,340,351 
7770 

specifying 338,351,477 
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